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PREFACE 


MANUAL OBJECTIVES 


This manual is a guide to the use of RMS-11l in programs written in 
MACRO-11. It contains information necessary to writing MACRO-11 
programs and subprograms that use RMS-11l operations. 


INTENDED AUDIENCE 


This manual is intended for both the MACRO-11 programmer who wants’ to 
use RMS-11 operations and the high-level language programmer who wants 
to use RMS-11l operations in a MACRO-11 subprogram. 


STRUCTURE OF THIS DOCUMENT 


e Chapter 1, Introduction to RMS-11l with MACRO-11, introduces 
RMS-ll macros and symbols that are the interface between a 
MACRO-11 program and RMS-11 operation routines. 


e Chapter 2, RMS-11 Programming in MACRO-11l, shows how to use 
RMS-11 macros and symbols in a MACRO-11 program. 


@e Chapter 3, Processing Directories and Files, shows how to use 
directory and file operations to process directories and 
files. 


@e Chapter 4, Processing Records and Blocks, shows how to- use 
stream operations and either record or block operations to 
process records or blocks. 


e Chapter 5, Operation Macro Descriptions, describes in detail 
each RMS-11 operation macro, the control blocks it uses, the 
options you can specify in each control block field, and the 
values returned in control block fields. 


e Chapter 6, Control Block Fields, summarizes the use of each 
control block, field, value, and mask. 


@e Chapter 7, Example Programs, contains programs and program 


segments that illustrate the uses of some major RMS-11 
features. 
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e Appendix A, Completion Codes and Fatal Error Codes, lists 
RMS-11 completion symbols, values, and meanings. 


e Appendix B, Assembly-Time Messages, lists the messages’ that 
RMS-11 macros can generate at assembly time. 


e Appendix C, Macros That Declare Symbols and Other Macros, 
describes RMS-1ll macros that declare other RMS-11 macros and 
define RMS-11 symbols. 


e Appendix D, RMS-11 with Different Operating Systems, 
describes the differences among the behaviors of RMS-11 with 
various operating systems. 


e The index includes a major entry for each RMS-11 macro, 
control block field mnemonic, keyword macro argument, and 
symbol family. 


ASSOCIATED DOCUMENTS 


RSX-11M/M-PLUS RMS-11l: An Introduction introduces the major concepts 
of RMS-ll, introduces the RMS-1l operations, and defines key terms 
required for understanding RMS-1l capabilities and functions. You 
should read the introduction before proceeding to other manuals in the 
RMS~-11l documentation set. 


The RSX-11M/M-PLUS RMS-11 User's Guide provides detailed information 
for both MACRO-11 and high-level language programmers on file and task 
design using RMS-ll. 


The RSX-lLIM/M-PLUS RMS-11l Utilities manual is both a user and a 
reference document for all users, both programmers and nonprogrammers. 
It describes the RMS-1l utilities that are available for creating and 
maintaining RMS-1l files. 


In addition, the RSX-11M/M-PLUS RMS-11l1 Mini-Reference Insert is an 
easy-reference guide for users who are familiar with RMS-1l and its 
documentation. It summarizes the RMS-1ll utilities and error codes. 


CONVENTIONS USED IN THIS DOCUMENT 


The following conventions are used in statement formats in this 
document: 


UPPERCASE Uppercase characters within a string indicate 
characters that you must include in the string; you 
can type the characters in uppercase or lowercase. 


lowercase Lowercase characters within a string indicate a 
user-selected variable; text following the 
statement format defines the syntax of the variable. 


i. Square brackets indicate that the enclosed string is 
optional user input. 


sie A horizontal ellipsis indicates that the immediately 


preceding optional string (enclosed in square 
brackets) may be repeated. 
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In examples of commands you enter. and system 
responses, all output lines and prompting characters 
that the system prints or displays are shown in 
black letters. All the lines you type are shown in 
red letters. 


A nonalphabetic character (except a square bracket 
or a period that is part of an ellipsis) indicates a 
character that you must include in the string. 


Numbers in this manual that give the values of RMS-11l symbols are in 
octal radix (base 8) unless otherwise indicated; all other numbers in 
this manual are in decimal radix (base 10). 
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SUMMARY OF TECHNICAL CHANGES 


This revision contains the following technical changes: 


The new operation macros SENTER, SPARSE, SREMOVE, SRENAME, 
and S$SEARCH are documented, along with the related NAM block 
fields FNB, RSA, RSL, and RSS. 


The new facility for wildcard file specification is 
documented. 


The extension of access sharing is documented, along with the 
related masks FBSUPI and FBSNIL for the SHR field of the FAB. 


Random access to a sequential file with fixed-length records 
(Similar to random access to a relative file) is documented. 


The new print-format record-output handling is documented, 
along with the related symbol FBSPRN for the RAT field of the 
FAB. 


The new sequential block access is documented; the previous 
block access (formerly called block I/0) is now called VBN 
access (virtual block number access). 


Block access can now be used to copy RMS-11 files without the 
need to modify the file's attributes manually. 


The addition of the success handler facility for file 
Operation macros (SCLOSE, SCREATE, SDISPLAY, SERASE, SEXTEND, 
and SOPEN) is documented. 


Increased device transparency for record access copy 
operations is supported. VFC and stream record formats are 
supported on unit-record devices. Relative and indexed files 
can be created for record access on nondisk devices, although 
they will appear as and be processed as sequential files 
there. 


The obsolete RMS-11 initialization macros SINIT and _ SINITIF 
are no longer documented. These macros are now defined as 
no-ops in the RMS-11l macro library RMSMAC.MLB; their 
previous functions are no longer needed because RMS-11 is now 
self-initializing. However, programs that use the SINIT and 
SINITIF macros in their previous senses remain valid under 
RMS-11 Version 2.0. 
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SUMMARY OF TECHNICAL CHANGES 


Each XAB type now has a distinct name; the following are the 
new names: 


ALL block Area allocation XAB 
DAT block File date XAB 

KEY block File key XAB 

PRO block File protection XAB 
SUM block File summary XAB 


The following symbol declaration macros are documented: 


FABSBT Declare FAB value and mask symbols 
NAMSBT Declare NAM block value and mask symbols 
RABSBT Declare RAB value and mask symbols 
XABSBT Declare XAB value and mask symbols 
XBAOFS Declare ALL block symbols 

XBDOFS Declare DAT block symbols 

XBKOFS Declare KEY block symbols 

XBPOFS Declare PRO block symbols 

XBSOFS Declare SUM block symbols 


The description of each operation macro includes the use and 
meaning of each associated control block field. 


The value of each RMS-11 user symbol is documented. 


The structure of each RMS-ll user control block is 
documented. 


The FAB has a new’ LRL (longest record length) field for 
sequential files (corresponding to the VAX-11 RMS XAB LRL 
field). 


The date/time XABS have changed in size from 36 to 46 octal 
bytes. 


For ANSI magtape, RMS-11 allows fixed-format records to _ be 
less than 18 bytes. 


<CTRL/Z> and <ESC> are no longer recognized as_ record 
terminators for stream files; and <CTRL/Z> is no longer 
recognized as a file terminator for stream files. 


RMS-11 now pads stream files with null characters to the high 
block of the file (not just to the end of the current block). 
This means that RMS-ll-created stream files can be read _ by 
programs that do not recognize the EOF value from the file 
header. 
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CHAPTER 1 


INTRODUCTION TO RMS-11 WITH MACRO-11 


RMS-11 macros and symbols provide access to RMS-11l operations from a 
MACRO-11 program. 


1.1 ADVANTAGES OF USING RMS-11 MACROS 
When you use RMS-11l operations from a high-level language, the 
language restricts your options for some operations. If you cannot 


accept these restrictions, you can write your program (or some of its 
modules) in MACRO-11; this allows you full access to RMS-11 options. 


1.2 RMS-11 MACROS AND SYMBOLS 

RMS~1ll macros and symbols define the interface between a MACRO-11 
program and RMS-1l operation routines. Definitions for these macros 
and symbols are in the RMS-11]1 macro library, RMSMAC.MLB. 

RMS-11 macros allow your program to: 


e Call RMS-11 operations 


@e Declare and manipulate control blocks, through which = your 
program communicates with RMS-1ll operation routines 


e Declare and manipulate space pools 
@e Declare needed RMS-11 facilities 


e Extract (from the macro library RMSMAC.MLB) definitions’ for 
RMS-11 macros and symbols 


The following sections introduce RMS-11 macros and symbols. 
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1.2.1 Operations 


An RMS-11 operation macro calls a routine that performs an RMS-11 
operation, The name of an operation macro is the name of the 
corresponding operation, with a prefixed dollar sign (S$). The 
following are the RMS-11 operation macros: 


Directory File Stream Record Block 
Operation Operation Operation Operation Operation 
Macros Macros Macros Macros Macros 
SENTER SCLOSE SCONNECT SDELETE SREAD 
SPARSE SCREATE SDISCONNECT SFIND SSPACE 
SREMOVE SDISPLAY SFLUSH SGET SWRITE 
SRENAME SERASE SFREE SPUT 
SSEARCH SEXTEND SNXTVOL STRUNCATE 

SOPEN SREWIND SUPDATE 

SWAIT 


An RMS-11 operation returns a value called a completion code _ that 
indicates either a successful operation or an error. RMS-11 
completion symbols give names to these completion codes. 


When your program uses an RMS-11 operation macro to call an operation 
routine, it can specify completion handlers (one for a successful 
completion, one for an error completion) that RMS-11 calls when the 
operation completes. The RMS-11l completion-return macro (SRETURN) 
generates a proper return from a completion handler to the calling 
point in your program. 


1.2.2 Control Blocks and Fields 


Your program and RMS-11 operation routines communicate by passing data 
in blocks called control blocks. Each control block is divided into 
fields; each field has a 3-letter mnemonic name. 


An RMS-11 block-declaration macro allocates space for a control block 
and initializes fields containing the block length and block 
identifier. There is a block-declaration macro for each kind of 
control block. 


An RMS-11 field-initialization macro sets an initial value for a 
control block field at assembly time. There are field-initialization 
macros for most control block fields (those that you might reasonably 
want to initialize). 


An RMS-1l field-access macro manipulates the value of a control block 
field during program execution. There are field-access macros for 
copying values to and from fields (SSTORE and SFETCH), for comparing 
field values with other values (SCOMPARE), and for setting, clearing, 
and testing bits in fields (SSET, SOFF, and STESTBITS). 


RMS-11 code and mask symbols give names to the codes and bit masks 
used in many fields. This allows your program to determine the 
details of an RMS-1l operation without using the numeric’ values 
associated with those details. 


RMS-11 field-offset symbols give names to the locations of fields 
within their control blocks. Because RMS-11l field-initialization and 
field-access macros are based on field names, your program need not 
use field-offset symbols. 
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RMS-11 control blocks and their general uses are as follows: 


e ALL (area allocation) block - contains information about a 
file area. 


e DAT (file date) block - contains file dates and the file 
revision number. 


e FAB (file access block) - contains general information about a 
file and how a program will access it. 


e KEY (file key) block - contains information about a file index 
and its key. 


@e NAM (file name) block - contains special information about the 
device, directory, and specification for the file, along with 
wildcarding information. 


@e PRO (file protection) block - contains file owner and 
protection information. 


e RAB (record access block) - contains general information about 
a stream anda record or block, and how the program accesses 
the record or block. 


e SUM (file summary) block - contains the number of areas and 
indexes in the file, and a_ version number indicating the 
internal structure level of the file. 


1.2.3 Pools 


RMS-1l conserves space by dynamically allocating and deallocating 
space set aside in pools. RMS-11 pool-declaration macros allocate 
space for pools. 


An RMS-11 routine called the get-space routine handles pooled space. 
You can substitute your own get-space routine for the RMS-11 routine; 
you can use RMS-11l get-space-address macros to initialize the address 
of the get-space routine at assembly time (GSAS), to change the 
address to that of a different routine during program execution 
(SSETGSA), and to return the address of the current routine during 
program execution (SGETGSA). 


1.2.4 Facilities 


The RMS-1l facilities-declaration macro (ORGS) assists RMS-1l1l in 
determining exactly which routines your program needs during program 
execution. 


1.2.5 Macros That Declare Symbols and Other Macros 


To extract the definition of an RMS-11 macro from the macro library, 
your program must declare the macro in a .MCALL assembler directive. 


Many RMS-1l macros declare related macros and define related symbols; 
some RMS~-1l macros have the sole purpose of declaring related macros 
and defining related symbols. Using these macros simplifies the job 
of declaring macros and defining symbols in your program. 
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For example, the FAB-declaration macro FABSB declares FAB 
field-initialization macros and FAB offset, code, and mask symbols; 
the SFBCAL macro declares all directory and file operation macros; 
the SRMSTAT macro declares all completion symbols. 


To use 
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RMS-11 PROGRAMMING 


RMS-11 operations in a MACRO-11 program, your program must: 


Declare RMS-11 macros and symbols 


Before your program refers to an RMS-1l macro or symbol, it 
must extract its definition from the RMS-11 macro library. 
Section 2.1 shows how to declare macros and symbols. 


Declare RMS-11 facilities 


To help RMS-11 decide which RMS-11 program modules are needed 
for your program, your program must declare some of the RMS-11 
operations that it uses. Section 2.2 shows how to declare 
RMS-11 facilities. 


Declare and use pool space 


RMS-11 dynamically allocates and deallocates space for some of 
its requirements; this space is separated into five pools. 
Using RMS-11 pool-declaration macros, you specify the size of 
each pool. Section 2.3 shows how to declare pool space. 


Declare and initialize control blocks 


Your program and RMS-1ll operation routines communicate by 
Passing data back and forth in control block fields. Using 
RMS-11 block-declaration and field-initialization macros, your 
program allocates space for control blocks and (optionally) 
assigns initial values for fields. Section 2.4 shows how to 
declare and initialize control blocks. 


Use RMS-11l operations 


Your program uses RMS-11l operation routines to perform record 
management services; the routines return values that show the 
results of the operations. Your program uses RMS-11 operation 
macros to call these operation routines. Section 2.5 shows 
how to call RMS-11l operation routines and how to handle 
returns from the routines. 


YOur program may also: 


Include completion handlers 


An RMS-11 operation routine returns either a success 
completion code or an error completion code. Your program can 
include special routines (called success handlers and error 
handlers) that operation routines call automatically when 
operations complete. Section 2.6 shows how to write 
completion handlers. 
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e Use its own get-space routines 


RMS-1l uses a routine (called a get-space routine) to allocate 
and deallocate space. RMS-1l has a get-space routine, but you 
can also supply others of your own. Section 2.7 shows how to 
use get-space routines and how to write a get-space routine. 


Finally, you must: 

e Assemble the program 
When you assemble your program, it needs macro and_= symbol 
definitions from RMS~-1ll; these are in a macro library, which 
your assembler command line must’ reference. RMS-1ll macros 
detect some kinds of errors during assembly, and print 
messages that identify the errors. Section 2.8 shows how to 
assemble your program. 

e Build the task 


When you build your task, you must do one of the following: 


- Use an RMS-11 resident library. 


- Define an overlay structure for the task. RMS-11 offers 
several overlay definition (ODL) files from which you can 
select; you can also write your own ODL files. 


-~ Include RMS-11 code in the task. 


2.1 DECLARING RMS-11 MACROS AND SYMBOLS 


Before your program refers to an RMS-11l macro or symbol, it must 
extract its definition from the RMS-11 macro library. 


Your program can use the .MCALL assembler directive to extract the 
definition of any RMS-11 macro (but not a symbol) from the macro 
library. For example, to extract the definition of the macro SCLOSE, 
use the .MCALL directive in the format: 


-MCALL SCLOSE sDeclare RMS-11 SCLOSE macro 


Your program can use RMS-1l macros to extract definitions for RMS-11 
symbols, and for some groups of other RMS-1l macros. Appendix C lists 
RMS-11 macros (with their arguments) that declare symbols and other 
macros. 


2.2 DECLARING RMS-11 FACILITIES 


To help RMS-1l decide which RMS-11 program modules your program needs, 
your program declares some of the operations that it uses. To do 
this, it uses the facilities-declaration macro ORGS in the format: 


»-MCALL ORGS ;Declare ORGS macro 
ORGS fileorg[,<operation[,operation]...>] 


where fileorg is a keyword indicating a file organization and each 
operation is a keyword indicating an operation that your program uses 
for a file of that organization. 
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A separate ORGS macro is required for each different file organization 
that your program processes, except that no ORGS macro is required for 
an organization that will be processed using only directory operations 
and block access. 


The fileorg keyword argument to the ORGS macro is one of the 
following: 


IDX Indexed file organization 
REL Relative file organization 
SEQ Sequential file organization 


Each operation argument to an ORGS macro is one of the following: 


CRE CREATE operation 

DEL DELETE operation 

FIN FIND operation 

GET GET operation 

PUT PUT operation 

UPD UPDATE operation 
These are the only operations that your program explicitly declares 
with the ORGS macro; support for other operations is handled 
automatically. 


For example, suppose that your program: 
e Creates both sequential and indexed files 


e Uses FIND, GET, PUT, and UPDATE operations for sequential 
files 


e Uses FIND, GET, PUT, and DELETE operations for indexed files 


Then the proper ORGS macros are: 


ORGS SEQ,<FIN,GET,PUT,UPD> ;Declare FIND, GET, PUT, and UPDATE 
: operations for sequential files 

ORGS IDX,<FIN,GET,PUT,DEL> ;Declare FIND, GET, PUT, and DELETE 
: operations for indexed files 


The results of ORGS macros are additive. For example, if one portion 
of your program specifies 


ORGS SEQ,<GET, PUT> 
and another specifies 
ORGS SEQ,<GET,UPD> 
then the effect is the same as specifying 
ORGS SEQ,<GET,PUT,UPD> 
Note also that all ORGS macros must occur in modules that are 
contained in the root segment of your task (not overlaid). Use of 


ORGS macros is optional in tasks linked with an RMS-11 memory-resident 
library. 
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2.3 DECLARING AND USING POOL SPACE 


RMS-11 dynamically allocates and deallocates space for some of its 
requirements; this space is separated into five pools: 


e Internal FAB and index descriptor block (IFAB/IDB) pool 

e Internal RAB (IRAB) pool 

e Key buffer pool 

e 1/0 buffer pool 

e Buffer descriptor block (BDB) pool 
RMS-1l has a get-space routine that manages these pools, and that 
allocates and deallocates space to meet the needs of RMS-11 
operations; however, you can supply other get-space routines and 
direct RMS-11 to use a different routine (and, optionally, different 
pools) instead of its own. 
If you use only the RMS-11 get-space routine, declare pool space using 
the pool-declaration macros described below. If you use your own 
get-space routine, read Section 2.7; it shows how to write the 


routine, and how to manage the pools. 


To declare space for pools, use pool-declaration macros in the format: 


POOLSB ;Begin pool declarations 

PSFAB fabcount ;Space for IFABs in IFAB/IDB pool 
PSIDX indexcount ;Space for IDBs in IFAB/IDB pool 
PSRAB rabcount *Space for IRABs for sequential 


and relative files and for 
block-accessed indexed files 
in IRAB pool 
PSRABX rabxcount,keysize,keychanges ;Space for IRABs for 
> record-accessed indexed 
+; files in IRAB pool, and 
; space for key buffers in 
; key buffer pool 
PSBUF bufcount ;Space for I/O buffers in I/0 
7 
; 


=e Me Ne 


buffer pool 
Space for BDBs in BDB pool 
End pool declarations 


PSBDB bdbcount 
POOLSE 


If your program uses multiple pool declarations, the results are 
cumulative. 


The following sections show how to compute the values of arguments’ to 
the pool-declaration macros. 
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2.3.1 Internal FAB and Index Descriptor Block Pool 


Internal FABs (IFABs) and index descriptor blocks (IDBs) are the same 
size and so share a pool (the IFAB/IDB pool). The total size of the 
pool is the sum of the following: 


e The largest number of IFABs that your program uses at the same 
time, times 48 bytes. Specify this largest number of IFABs 
(not multiplied by 48) as the fabcount argument to the PSFAB 
macro. 


A directory operation uses one IFAB, which is returned to’ the 
pool before the operation completes. 


A CREATE or OPEN operation uses one IFAB, which is committed 
while the file is open; a CLOSE operation releases the IFAB. 
A DISPLAY or EXTEND operation uses no new IFABs; it uses’~ the 
IFAB already committed to the open file. An ERASE operation 
uses one IFAB, which is released before the operation 
completes. 


e The largest number of IDBs that your program uses at the same 
time, times 48 bytes. Specify this largest number of IDBs 
(not multiplied by 48) as the indexcount argument to the PSIDX 
macro. 


Your program uses one IDB for each index of each indexed file 
opened for record access (rather than block access). The IDBs 
for an indexed file are committed when the file is opened (by 
a CREATE or OPEN operation) and are released when the file is 
closed (by a CLOSE operation). 


2.3.2 Internal RAB Pool 


Internal record access blocks (IRABs) have a separate pool. The size 
of the IRAB pool is the largest number of streams that your program 
will have connected at the same time, times the size of an IRAB_ (32 
bytes). 


Specify the largest number of streams connected to sequential files, 
relative files, and block-access indexed files (not multiplied by 32) 
as the rabcount argument to the PSRAB macro. Specify the largest 
number of streams connected to record-access indexed files as the 
rabxcount argument to the PSRABX macro. 


If the sum of the rabcount and rabxcount arguments is larger than the 
largest number of streams that will ever be connected simultaneously, 
you may deduct the excess from the rabcount argument that you specify. 


An IRAB is committed when a stream is connected and is released when 
the stream is disconnected or the file is closed (using the associated 
FAB). 
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2.3.3 Key Buffer Pool 


Key buffers have a separate pool. (These key buffers are different 
from those specified by the KBF and KSZ fields of the RAB.) 


Each time a stream is connected to an indexed file (for record 
access), the CONNECT operation requests space from the key buffer 
pool; the space is released when the stream is disconnected or the 
file is closed. 


Compute the size (in bytes) of the request that the CONNECT operation 
makes as follows: 


1. Begin with the size of the largest key for the file. 
2. Multiply by 2. 


3. Add the number of alternate keys for the file that are 
allowed to change during updating. 


4, Addl. 
5. Round up (if necessary) to a multiple of 4. 


If your program performs complex sequences of CONNECT and DISCONNECT 


(or CLOSE) operations for record-access indexed files with different 
key sizes, the key buffer pool may become fragmented (and therefore 
contain unusable space). In this case, the total size of the key 


buffer pool should be larger than the sum of the requirements for each 
connected stream. 


Each PSRABX macro that your program uses (in the format PSRABX 
rabxcount,keysize,keychanges) allocates a number of bytes for the key 
buffer pool that is equal to 


(rabxcount) x ((keysize * 2) + keychanges + 1) 


The expression ((keysize * 2) + keychanges + 1) is rounded up (if 
necessary) to a multiple of 4. 


You can use PSRABX macros to precisely tailor the size of the key 
buffer pool, or to provide extra space against possible fragmentation 
problems. A good compromise is to choose the arguments to the PSRABX 
macro as follows: 


e Choose rabxcount as the largest number of streams that will be 
connected to record~access indexed files. 


e Choose keysize as the largest key in any file that will be 
processed. 


e Choose keychanges as the maximum number of changeable keys in 
any file that will be processed. 


2.3.4 I/0 Buffer Pool 


The I/O buffers for RMS-1l operations come either from the central 
buffer pool or from a private buffer pool. (These are RMS~-11l internal 
I/O buffers, and are different from the I/O buffers specified in the 
RBF, RSZ, UBF, and USZ fields of the RAB.) 
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Your program can specify a private buffer pool for a directory or file 
operation (except CLOSE, DISPLAY, or EXTEND). If your program does 
not specify a private buffer pool, these operations use the central 
buffer pool. 


All other operations that require I/O buffers use the same pool as the 
CREATE or OPEN operation that opened the file. 


The minimum size of the central I/O buffer pool is the sum of the 
sizes of the I/0 buffers that your program will need from it at the 
same time (ignoring I/O buffers supplied from private buffer pools). 
Specify the size (in bytes) of the central buffer pool as the 
iopoolsize argument to the PSBUF macro. 


Specify the size (in bytes) of a private buffer pool for an operation 
in the 1-word BPS field of the FAB and the address in the l-word BPA 
field of the FAB. If your program specifies a private buffer pool for 
a CREATE or OPEN operation, the entire pool is reserved for and 
managed by that file until the file is closed. 


Your program needs space from buffer pools for the following: 


@e One 512-byte I/0 buffer for any directory or file operation 
(except CLOSE, DISPLAY, or EXTEND). This space is released 
before the operation completes. 


e One 512-byte I/O buffer for a DISPLAY or EXTEND operation for 
a record-access relative or indexed file; the space is 
returned when the operation completes. 


e I/0 buffers for a CONNECT operation: 


- One I/O buffer for a record-access stream connected to a 
sequential disk file. The I/0 buffer uses 512 bytes times 
the multiblock count for the stream. 


- One I/O buffer for a record-access stream connected to a 
sequential magtape file. © The number of bytes in the I/0 
buffer is the block size for the file, rounded up (if 
necessary) to a multiple of 4 bytes. 


- One I/O buffer for a record-access stream connected to a 
file on a unit-record device. The number of bytes in the 
I/O buffer is equal to the default block size for the 
device, rounded up (if necessary) to a multiple of 4 bytes. 


- One or more I/0O buffers for a stream connected to a 
relative file. Each I/0 buffer uses 512 bytes times the 
bucket size for the file. If you use the multibuffer count 
to specify additional buffers, the requirement increases 
accordingly. 


- Two or more I/O buffers for a stream connected to an 
indexed file. Each I/0 buffer uses 512 bytes times the 
bucket size for the file. If you use the multibuffer count 
to specify additional buffers, the requirement increases 
accordingly. 


I/O buffers for a connected stream are retained until the 
stream is disconnected by a DISCONNECT or CLOSE operation. 
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If your program uses the I/0 buffer pool for complex sequences’ of 
operations that use I/0 buffers for different files, the pool may 
become fragmented. In that case, you may want to either allocate 
extra space in the I/O buffer pool, or limit fragmentation through the 
judicious use of private buffer pools. 


2.3.5 Buffer Descriptor Block Pool 


Your program requires one 20-byte buffer descriptor block (BDB) for 
each I/0 buffer (whether from the central or a private pool) that it 
uses at the same time; these BDBs are allocated and returned at the 
same time as their associated I/O buffers. (I/0 buffer requirements 
are described in the previous section.) 


In addition, a block-access stream (for any file) or a record-access 
stream that will write to a relative file requires an additional BDB; 
a record-access stream that will write to an indexed file requires two 
additional BDBs. These BDBS are returned when the stream is 
disconnected (or the file is closed). 


An EXTEND operation for a record-access relative or indexed file also 
requires an additional BDB, which is’ returned when the operation 
completes. 


Therefore the size of the BDB pool is the largest number of BDBs 
required at any one time, times 20 bytes. Specify this largest number 


of BDBs (not multiplied by 20) as the bdbcount argument to the PSBDB 
macro. 


2.4 DECLARING AND INITIALIZING CONTROL BLOCKS 

Your program and RMS-11 operation routines communicate by passing data 
back and forth in control block fields. Using RMS-11 
block-declaration and field-initialization macros, you allocate space 
for control blocks and (optionally) assign initial values for fields. 


To declare a control block and initialize its fields, use 
block-declaration and field-initialization macros as follows: 


1. Make sure the control block is word-aligned by using the 
-EVEN directive: 


EVEN ;Word-align block 


2. Specify a label so that your program can refer symbolically 
to the address of the control block. 


label: 


3. Begin the block declaration with one of the following macros: 


FABSB ;Begin FAB declaration 
NAMSB ;Begin NAM block declaration 
RABSB SYN ;Begin RAB declaration for 

; synchronous RAB 
RABSB ASYN ;Begin RAB declaration for 

; asynchronous RAB 
XABSB XBSALL ;Begin ALL block declaration 
XABSB XBSDAT ;Begin DAT block declaration 
XABSB XBSKEY ;Begin KEY block declaration 
XABSB XBSPRO 7;Begin PRO block declaration 
XABSB XBSSUM ;Begin SUM block declaration 
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4. Initialize (optionally) fields with field-initialization 
macros of one of the forms: 


FSfld arg s;Initialize FAB field 
NSfld arg ;Initialize NAM block field 
RSfld arg ;Initialize RAB field 
X$f1ld arg ;Initialize XAB field 


In each of these forms, fld is the mnemonic for a field in 
the control block; arg is an argument suitable for the value 
of the field. Chapter 6 describes field-initialization 
macros and their arguments. 


5. End the block declaration with one of the following macros: 


FABSE sEnd FAB declaration 
NAMSE sEnd NAM block declaration 
RABSE ;End RAB declaration 
XABSE sEnd XAB declaration 


2.5 USING RMS-11 OPERATIONS 


Your program uses RMS-l11 operation routines to perform record 
Management services. Using RMS-11 operation macros, you call these 
operation routines. The routines return values in control block 
fields that show the results of the operations. 


To use RMS-11 operation routines, your program must: 
e Set up control block fields 


The values that your program places in control block fields 
specify the details of the service you want from the RMS-1l 
operation routine. Section 2.5.1 shows how to set up control 
block fields. 


e Chain control blocks 


Some RMS-1l operation routines (stream, record, and _ block 
operation routines) read only RAB fields; others (directory 
and file operation routines) read FAB fields and, if your 
program supplies them, fields in NAM blocks and XABs. Your 
program chains these blocks (using address pointers) so that 
the operation routine can find them. Section 2.5.2 shows how 
to chain control blocks. 


e Call operation routines 


You use RMS-1l operation macros to call RMS-11l operation 
routines. Section 2.5.3 shows how to call operation routines. 


e Handle returns 


Section 2.5.4 shows how to handle returns from operation 
routines. 


e Examine returned values 


When an RMS-11 operation routine completes its execution, it 
has placed values in control block fields that show the 
results of the operation. Your program should examine these 
values to determine the results. Section 2.5.5 shows how to 
examine returned values. 
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2.5.1 Setting Up Control Block Fields 


The values that your program places into control block fields specify 
the details of the service you want from the RMS-1l operation routine. 
The description of each operation macro in Chapter 5 discusses’ the 
control block fields that are read by that operation. 


Three RMS-1l field-access macros help you place values into control 
block fields: 


e SSTORE places a specified value into a field. 
e SSET sets bits ina field. 


e SOFF clears bits ina field. 


2.5.1.1 S$STORE Macro - Use the SSTORE macro to copy a value from a 
specified location to a control block field. The format for the 
SSTORE macro is: 


SSTORE src,fld,reg 


where sre is a an address in memory; fld is a field mnemonic; and 
reg is a general purpose register (RO through R5) containing the 
address of the control block. 


The SSTORE macro looks up the size of the destination field, so that 
it can copy the correct number of bytes or words. If the source is a 
register and the destination is a l-byte field, then the low byte of 
the register is copied; if the source is a register and the 
destination is a multiword field, then the contents of the specified 
register and following registers are copied. 


The SSTORE macro generates an error during assembly if you use an 
illegal address mode for the source. For multiword fields, illegal 
address modes are autoincrement deferred, autodecrement deferred, and 
indexed deferred. 


It is also illegal to specify the program counter (PC) as the _ source 
or to specify a register as source in such a way that the source 
overlaps the register that contains the control block address. 


At execution time, the SSTORE macro copies the contents of the 
specified location to the control block field. The number of bytes or 
words copied is the same as the field size for the mnemonic. Chapter 
6 gives the size of each control block field. 

For example, suppose that you want to specify indexed file 
Organization in the FAB for a file, and suppose that the address of 
that FAB is stored in register R2. Then the proper macro is: 

SSTORE #FBSIDX,ORG,R2 s;Indexed file organization 


Suppose that you want to chain a NAM block whose label is NAMBLK_ to 
the same FAB. Then the proper macro is: 


SSTORE  #NAMBLK,NAM,R2 sChain NAM block 
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Suppose that you want to set the allocation quantity (ALQ field) of 
the same FAB to the value stored in a location labeled ALQVAL. Then 
the proper macro is: 


SSTORE ALQVAL,ALQ,R2 ;Load allocation quantity 


and (because ALQ is a 2-word field) two words are copied from ALQVAL 
to the ALQ field. 


2.5.1.2 S$SET Macro - Use the SSET macro to set bits in a 1-byte or 
l-word control block field. The SSET macro logically ORs a given mask 
into the control block field. Therefore for each bit set in the mask, 
the SSET macro sets the corresponding bit in the field; the other 
bits are not changed. 7 


Note that you use the SSET macro only if you want to leave some bits 
in a field undisturbed; if you want to set specified bits and clear 
all others, use the SSTORE macro. 


The format for the SSET macro is: 
SSET mask,fld,reg 


where mask is an address in memory containing bits to be set; fld is 
the mnemonic for a control block field; and reg is a general purpose 
register (RO through R5) containing the address of the control block. 


If the field is not a l-byte or l-word field, the SSET macro generates 
an error during assembly. 


RMS-11 has symbols for masks for each bit-oriented control block 
field. Therefore your program can use these symbols instead of 
numerical values. 


For example, SUPpOsG you want to specify rewind-on-close in the FAB 
for a file, but do not want to disturb other bits in the FOP field of 
the FAB; suppose also that the address of the FAB is in register R2. 
Then the proper macro is: 


SSET #FBSRWC,FOP,R2 ;Rewind-on-close 


As another example, suppose you want to specify key-duplicates-allowed 
and key-changes-allowed for an index, but do not want to disturb other 
bits in the FLG field of the KEY block; suppose also that the address 
of the KEY block is in register R4. Then the proper macro is: 


SSET #XBSDUP! XBSCHG,FLG,R4 ;Allow key duplicates and changes 


2.5.1.3 SOFF Macro - Use the SOFF macro to clear bits in a 1l-byte or 
l-word control block field. The SOFF macro logically ANDs the l's 
complement of a given mask into the control block field. Therefore 
for each bit set in the mask, it clears the corresponding bit in the 
field; the other bits are not changed. 


Note that you use the SOFF macro only if you want to leave some bits 
in a field undisturbed; if you want to clear the entire field, use 
the SSTORE macro (with a source value of #0). 
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The format for the SOFF macro is: 
SOFF mask,fld,reg 


where mask is an address in memory containing bits to be cleared; fld 
is the mnemonic for a control block field; and reg is a general 
purpose register (RO through R5) containing the address of the control 
block. 


If the field is not a l-byte or l-word field, the SOFF macro generates 
an error during assembly. 


RMS-1ll has symbols for masks for each bit-oriented control block 
field. Therefore your program can use these symbols instead of 
numerical values. 


For example, suppose you want to specify no-rewind-on-close in the FAB 
for a file, but do not want to disturb other bits in the FOP field of 
the FAB; suppose also that the address of the FAB is in register R2. 
Then the proper macro is: 


SOFF #FBSRWC,FOP,R2 ;No rewind-on-close 


As another example, suppose you want to specify 
no~key-duplicates-allowed and no-key-changes-allowed for an index, but 
do not want to disturb other bits in the FLG field of the KEY block; 
Suppose also that the address of the KEY block is in register R4. 
Then the proper macro is: 


SOFF #XBSDUP! XBSCHG,FLG,R4 ;No key duplicates or changes 


2.5.2 Chaining Control Blocks 


An RMS-1l directory operation or file operation uses at least one FAB; 
you specify FABs in the operation macros that call the operation 
routines. 


For some directory operations, a NAM block is~ required; it is 
optional for other directory operations and for file operations. You 
specify a NAM block and XABs for an operation by chaining them to’ the 
FAB for the operation. 


2.5.2.1 Chaining a NAM Block to ae FAB —- Specify the NAM _ block 
associated with a FAB by placing its address in the l-word NAM field 
of the FAB. 


2.5.2.2 Chaining XABs to a FAB — Specify the XABs associated with a 
FAB by placing the address of the first XAB in the l-word XAB field of 
the FAB; in each XAB, specify the address of the next xXAB in the 
chain in the 1l-word NXT field of the XAB; in the last XAB in the 
chain, specify 0 in the NxT field. 


Follow these rules in ordering XABsS in a chain: 


e Place ALL blocks together in the chain. Each ALL block is 
"numbered" by the value in the l-byte AID field of the ALL 


block; chain ALL blocks so that these numbers are in 
ascending order. For the CREATE operation, begin with 0 and 
do not skip numbers in the ascending sequence; for other 


operations, you can skip numbers in the sequence. 
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e Place no more than one DAT block in the chain. 


e Place KEY blocks together in the chain. Each KEY block is 
"numbered" by the value in the l-byte REF field of the KEY 


block; chain KEY blocks so that these numbers are in 
ascending order. For the CREATE operation, begin with 0 and 
do not skip numbers in the ascending sequence; for other 


operations, you can skip numbers in the sequence. 
e Place no more than one PRO block in the chain. 


e@e Place no more than one SUM block in the chain. 


2.5.2.3 Chaining a FAB to a RAB (CONNECT Operation) - The CONNECT 
operation creates a stream for a file. A FAB specifies the file; a 
RAB specifies the stream. Specify the address of the FAB for the file 
in the l-word FAB field of the RAB for the stream. 


2.5.3 Calling Operation Routines 


Use RMS-ll operation macros to call operation routines. You can 
specify arguments for the operation routine either by giving them as 
arguments to the operation macro, or by placing them in an argument 
block in memory. 


2.5.3.1 Call with Macro Arguments - Call an operation routine (except 
RENAME) using an operation macro with arguments in the format: 


Smacroname blkaddr[,ferraddr] [,sucaddr]] 


where Smacroname is the name of an operation macro (except SRENAME); 
blkaddr is the address of a FAB (for a directory or file operation) or 
a RAB (for a stream, record, or block operation); erraddr is the 


address of an error handler for the operation; and sucaddr is the 
address of a success handler for the operation. 


For example, if you want to open a file using a FAB at address INFAB 
and want to use a success handler at address SUCCES, the macro call 
would be: 


SOPEN #INFAB,,#SUCCES 


Call the RENAME operation using the SRENAME operation macro with 
arguments in the format: 


SRENAME oldfabaddr,[erraddr],{sucaddr] ,newfabaddr 


where oldfabaddr is the address of a FAB for. the old file 


specification; erraddr is the address of an error handler for the 
operation; sucaddr is the address of a success handler for. the 
operation; and newfabaddr is the address of a FAB for the new file 


specification. 
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2.5.3.2 Call with Arguments in Memory - To call an operation routine 
using an operation macro with arguments in an argument block in 
memory, omit the arguments to the macro, store the address of the 
argument block in register R5, and store the argument block in memory 
as follows: 


ena 


ZK-1097-82 


The argument count is 4 for a RENAME operation; otherwise it is one 
of the following: 


e 1 - no completion handlers 
e 2 - error handler, but no success handler 
e 3 - success handler 


If the operation has no error handler, but either has a= success 
handler or the operation is RENAME, specify -l as the address of the 
error handler; if the operation has no success handler, but’ the 
Operation is RENAME, specify -l as the address of the success handler. 


2.5.4 Handling Returns 


An RMS-11 file or directory operation returns a completion status code 
in the l-word STS field of the FAB and, for some completions, a 
completion status value in the l-word STV field of the FAB. 


An RMS-1l stream, record, or block operation returns a completion 
Status code in the 1l-word STS field of the RAB and, for some 
completions, a completion status value in the l-word STV field of the 
RAB. 


Appendix A lists completion codes. 


Your program should examine the STS field contents to determine 
whether the operation was successful; even if the operation returned 
an error completion, your program may be able to handle the error’ and 
recover. 


The program can handle the return (based on the completion code) 
either in the code that immediately follows the operation macro, or in 
special routines (called completion handlers) that the operation can 
call. Section 2.6 shows how to write completion handlers. 
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There are two kinds of fatal RMS-11l errors: 


e If the FAB or RAB address you specify is not the address of a 
valid and idle FAB or RAB, or if the argument block you 
provide is invalid, RMS-1l1 cannot return values, even in the 
STS field. RMS-11 issues a BPT instruction, leaving status 
information in the following registers: 


RO: RMS-11 fatal error code 

Rl: Stack pointer (at time of entry to RMS-11 routine) 
R23: Program counter (entry return same as @R1) 

R3: Address of system impure area 


e If RMS-11 detects the corruption of memory-resident data 
structures, or if it detects inconsistent internal states, it 
cannot proceed with its operations. In these cases, RMS-11 
halts execution with a BPT instruction; if it can identify 
the error, RMS-1l leaves an error completion in RO. 


Appendix A lists the symbols and values for RMS-11 fatal error codes. 


2.5.5 Examining Returned Values 


When an RMS-11 operation routine completes its execution, it has 
Placed values in control block fields that show the results of the 
Operation. Your program should examine these values to determine the 
results. The description of each operation macro in Chapter 6 
discusses the control block fields that return values for that 
operation, 


Three RMS-11 field-access macros help you examine values in control 
block fields: 


e SFETCH copies a value from a field to a specified location. 
@e SCOMPARE compares a field value to a specified value. 


e STESTBITS determines whether specified bits in a field are 
set. 


2.5.5.1 S$FETCH Macro - Use the S$FETCH macro to copy a value from a 
control block field to a specified location. The format for the 
SFETCH macro is: 


SFETCH dst,fld,reg 


where dst is an address in memory; fld is the mnemonic for a_ control 
block field; and reg is a general purpose register (RO through R5) 
containing the address of the control block. 


The SFETCH macro looks up the size of the source field, so that it can 
copy the correct number of bytes or words. If the destination is a 
register and the source is a l-byte field, then the byte is copied to 
the low byte of the register and the high byte is cleared. if the 
destination is a register and the source is a multiword field, then 
the multiword field is copied to the specified register and following 
registers. 
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The SFETCH macro generates an error during assembly if you use an 
illegal address mode for the destination. For multiword fields, 
illegal address modes are autoincrement deferred, autodecrement 
deferred, and indexed deferred. Immediate mode is illegal for SFETCH, 
regardless of field size. 


It is also illegal to use the program counter (PC) as the destination 
or to specify a register for the destination in such a way that the 
destination overlaps the register that contains the control block 
address. 


At execution time, the S$FETCH macro copies the contents of the control 
block field to the specified location. The number of bytes or words 
copied is the same as the field size for the mnemonic. Chapter 6 
gives the size of each control block field. 


As an example of the use of the SFETCH macro, suppose that you want to 
fetch the allocation quantity (ALQ field) from a FAB to a location 
labeled ALQSAV, and suppose also that the address of the FAB is in 
register R3. Then the proper macro is: 

SFETCH ALQSAV,ALQ,R3 ;Save allocation quantity 


and two words are copied from the ALQ field to memory beginning at 
ALQSAV. 


2.5.5.2 SCOMPARE Macro — Use the SCOMPARE macro to compare the 
contents of a 1-byte or l-word control block field with a specified 
value. The format for the SCOMPARE macro is: 

SCOMPARE src,fld,reg 
where sre is an address in memory; fld is the mnemonic for a_ control 
block field; and reg is a general purpose register (RO through R5) 
containing the address of the control block. 


If the given field is not a l-byte or l-word field, the S$COMPARE macro 
generates an error during assembly. 


At execution time, the SCOMPARE macro executes a machine instruction 
that compares the source value and the field contents. The 
instruction executed depends on the size of the specified field and on 
the specified source: 

e TSTB for a 1l-byte field and the source #0 

e TST for a l-word field and the source #0 

@e cCMPB for a l-byte field and a source other than #0 

e CMP for a l-word field and a source other than #0 
Chapter 6 gives the size of each control block field. 
For example, suppose that you want to compare the value in the = RSZ 
field of a RAB with a value stored in a location labeled RSZSAV, and 
Suppose also that the address of the RAB is stored in register R2. 


Then the proper macro is: 


SCOMPARE RSZSAV,RSZ,R2 ;Compare record size 
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Suppose that you want to compare the same RSZ field to the value of a 
symbol, RECSIZ. Then the proper macro is: 


SCOMPARE #RECSIZ,RSZ,R2 ;Compare record size 


2.5.5.3 STESTBITS Macro - Use the STESTBITS macro to test the values 
of bits in a 1-byte or l-word control block field. Chapter 6 gives 
the size of each control block field. The format for the STESTBITS 
macro is: 


STESTBITS mask,fld,reg 


where mask is an address in memory containing bits to be tested; fld 
is the mnemonic for a control block field; and reg is a general 
purpose register (RO through R5) containing the address of the control 
block. 


If the given field is not a l-byte or 1-word field, the STESTBITS 
macro generates an error during assembly. 


At execution time, the STESTBITS macro executes a machine instruction 
that tests the bits specified in the mask. The instruction executed 
depends on the size of the specified field: 


e BITB for a l1-byte field 
e BIT for a l-word field 


For example, suppose you want to determine whether the terminal device 
is set in the DEV field of a FAB, and suppose that the address of the 
FAB is in register R3 Then the proper macro is: 


STESTBITS #FBSTRM,DEV,R3 ;Terminal device? 


As another example, suppose that you want to determine whether either 
the contiguous-area or the hard-location bit is set in the AOP field 
of an ALL block, and suppose that the address of the ALL block is in 
register R2. Then the proper macro is: 


STESTBITS #XBSCTG!XBSHRD,AOP,R2 ;Contiguous or hard location? 


2.6 WRITING COMPLETION HANDLERS 


Recall that when you use an RMS-11l operation macro, you can specify 
the addresses of completion handlers for the operation; if you do so, 
the operation automatically calls the error handler (for a nonfatal 
error completion) or the success handler (for a success completion) 
when the operation completes, before control returns to your program. 


When execution control passes to your completion handler, it finds the 
following situation: 


@e Register R5 contains the address of the argument block for the 
operation. 


If the operation is asynchronous, the address is the address 
of a copy of the original argument block for the operation. 


e The second word of the argument block contains the address of 
the FAB or RAB for the operation. (Recall that the STS and 
STV fields of the FAB or RAB contain the completion code and 
completion value for the operation.) 
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e If the operation was RENAME, the fifth word of the argument 
block contains the address of a second FAB for the operation. 


@e Other blocks are chained as they were when you used the 
operation macro that called the operation routine. 


A completion handler cannot determine from these values which RMS-11 
operation was executed, or what part of your program called the 
operation routine. You can, however, use the l-word CTX field of the 
FAB or the l-word CTX field of the RAB to indicate the context of the 
operation; RMS-11 does not disturb values in CTX fields. 


The completion handler must preserve the stack pointer (SP), and must 
end with the RMS-11 completion-return macro in the format: 


SRETURN ;End of completion handler 


2.7 USING GET-SPACE ROUTINES 


Your program can provide and use get-space routines other than the one 
provided with RMS-1l. It can set an initial get-space routine at 
assembly time, and it can change to other routines during program 
execution. Section 2.7.1 shows how to specify get-space routines, and 
how to obtain the address of the current get-space routine. Section 
2.7.2 shows how to write a get-space routine. 


2.7.1 Specifying Get-Space Routines 


To specify a get-space routine at assembly time, use the GSAS macro in 
the format: 


GSAS address ;Initialize get-space routine 
* address 


where address is the get-space routine entry address. If you’ specify 
0 as the address, or if you do not use the GSAS macro, the initial 
get-space routine for the program is the RMS-1]1 routine. 


For example, to specify a routine that begins at the label MYSPAC, you 
would use: 


GSAS MYSPAC 


To change the get-space routine during program execution, use _ the 
SSETGSA macro in the format: 


SSETGSA pointer ;Change get-space routine 
where pointer is the address of a location that contains the get-~space 
routine entry address. If you specify the entry-point address as 0, 


the new get-space routine established is the RMS-11 routine. 


For example, to specify a routine that begins at the label NEWSPC, you 
could use: 


SSETGSA #NEWSPC 


Alternatively, if the location GSATMP contains the value NEWSPC, you 
could use: 


SSETGSA GSATMP 
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To obtain the address (in RO) of the current get-space routine during 
program execution, use the SGETGSA macro in the format: 


SGETGSA ;Get-space routine address into RO 


If the address returned in RO is 0, the current get-space routine is 
the RMS-11 routine. 


2.7.2 Writing a Get-Space Routine 


A get-space routine handles space in contiguous blocks. For a request 
for space, it allocates a contiguous block of space (or denies the 
request); for a release of space, it accepts a contiguous’ block of 
space. 


A get-space routine must have a proper interface to calling routines, 
and it should handle unallocated space properly. 


2.7.2.1 Get-Space Routine Interface - When RMS-11 calls a _get-space 
routine, it either requests or releases a block of space. For a 
request for space, registers RO through R2 contain the following 
values: 


RO Address of pool free-space list (see next section) 
Rl Size (in bytes) of requested block 
R2 0 


If the get-space routine fills the request, it must clear the C bit 
and return the address of the first word of the allocated block in RO; 
if it does not fill the request, it must set the C bit. In either 
case, the routine must preserve the stack and registers R3 through R6. 


For a release of a block of space, registers RO through R2 contain the 
following values: 


RO Address of pool free-space list (See next section) 
R1 Size (in bytes) of released block 
R2 Address of first word being released 


For a release-space operation, the get-space routine returns no 
values; however, it must preserve the stack and registers R3 through 
R6. 


2.7.2.2 Pool Free-Space Lists - When RMS-11 calls your get-space 
routine, the address of a pool free-space list is in register RO. 
This free-space list specifies free space in one of tthe five pools 
described in Section 2.3; you can use this pool (which may or may not 
have adequate free space), or you can use a pool of your own. 


The free-space list chains free contiguous blocks of the pool. The 
first word of each block contains the address of the next block; if 
the first word of a block is 0, it is the last block in the list. 


Blocks in the list are ordered by ascending virtual addresses; their 
addresses are word-aligned; their sizes are multiples of 4 bytes 
(allocations and deallocations must be rounded up to a multiple of 4, 
if necessary). 
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The second word of each block contains the size (in bytes) of the 
block, including the 4-byte header; the first "block" in the list 
contains 0 in its second word, since it is the header block for the 
List, 


Your get-space routine can use the specified pool list to get space 
for RMS-1l; if it does this, it must properly maintain the list, and 
must (if possible) merge blocks back into the pool. 


The system routines SRQCB and $RLCB are suitable for handling pool 
free-space lists. These routines have interfaces that meet the 
requirements for your get-space routine; therefore your program can 
jump to SRQCB (for a space request) or SRLCB (for a space release). 


2.8 ASSEMBLING THE PROGRAM 


When you assemble your program, you must cause the assembler to get 
RMS-1l1 macro and symbol definitions from a library, and you may have 
to correct errors indicated by messages from RMS-11l macros. 


2.8.1 Assembling with the RMSMAC Macro Library 


When you assemble your program, the assembler needs definitions’ for 
the RMS-1l macros and symbols that your program uses; these are in 
the RMS-11 macro library, RMSMAC.MLB. Include the following reference 
to the RMS-11 macro library in your assembler command string: 


LB: [1,1] RMSMAC.MLB/ML 


2.8.2 Assembly-Time Errors from RMS-11 Macros 


RMS-11 macros detect some errors during assembly. For each such 
error, a macro issues a .PRINT or .ERROR assembler directive with a 
message. Appendix B describes RMS-ll macro-generated messages and 
their meanings. 


CHAPTER 3 
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This chapter discusses use of RMS-11 directory and file operations. 
The next sections discuss information and usage common to several 
directory and file operations: 

@e Device characteristics 

e Logical channels 

e File specifications and identifiers 

e Private buffer pools 


@ Completion status 


The sections after those provide an overview of the operations 
themselves (see Chapter 5 for detailed discussions): 


e Directory operations (except SEARCH): ENTER, REMOVE, RENAME 
and PARSE 


e File operations: CREATE, OPEN, DISPLAY, ERASE, EXTEND, and 
CLOSE 


Finally, the last sections discuss: 
e SEARCH operation 


e Writing wildcard loops 


3.1 DEVICE CHARACTERISTICS 


A directory or file operation (except CLOSE, DISPLAY, or EXTEND) 
returns device characteristics. These characteristics are returned as 
masks in the l-byte DEV field of the FAB. The device characteristics 
are: 


@e Printer or terminal (indicated by the set FBSCCL mask in the 
l-byte DEV field of the FAB and the set FBSREC mask in the 
l-byte DEV field of the FAB; for a terminal, the FBSTRM mask 
in the 1l-byte DEV field of the FAB is also set); RMS-1l1 
treats a printer or terminal as a unit-record device. 


@e Disk, DECtape, or DECTAPE II (indicated by the set FBSMDI mask 
in the 1l-byte DEV field of the FAB); RMS-1l1l treats a disk, 
DECtape, or DECTAPE II as a disk device. 
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@e Unit-record device (indicated by the set FBSREC mask in the 
l-byte DEV field of the FAB). 


e Non-ANSI magtape or cassette tape (indicated by the set FBSSDI 
mask in the 1l-byte DEV field of the FAB and the set FBSREC 
mask in the l-byte DEV field of the FAB); RMS-ll treats a 
non-ANSI magtape or a cassette tape as a unit-record device. 


e ANSI-format magtape (indicated by the set FBSSQD mask in the 
l-byte DEV field of the FAB). 


3.2 LOGICAL CHANNELS 


An RMS-11 directory or file operation (except CLOSE, DISPLAY, or 
EXTEND) requires a logical channel; this channel is a path from the 
program to a specified device. 


When your program executes a CREATE or OPEN operation on the channel, 
the path is extended to the target file; until the file is closed, 
the channel is reserved for the specified FAB. 


Your program specifies the logical channel for a directory operation 
or for a CREATE, ERASE, or OPEN operation in the l-byte LCH field of 
the FAB; the channel must not already be in use by the task. 


You can specify the initial device assignment for a logical channel in 
a Task Builder command file. The Task Builder also provides default 
initial device assignments for certain channels. Other logical 
channels are unassigned when your task begins executing. 


During task execution, channel assignments are made or changed by use 
of the ALUNS system directive. For example, RMS-11 uses the ALUNS 
directive to assign a logical channel for a directory operation or for 
a CREATE, ERASE, or OPEN operation; if the FAB and NAM block specify 
a device or device identifier, RMS-ll assigns the channel to that 
device; if the FAB and NAM block do not specify a device or device 
identifier, RMS-11l retains the device-channel assignment (if any), or 
asSigns the channel to the device SY:. 


3.3 FILE SPECIFICATIONS AND IDENTIFIERS 


A file specification consists of the following elements (in the order 
given): 


e Device specification - the device where the file resides 


e Directory specification - the directory on the device through 
which the file can be found 


e File name - the name by which the file is known in the 
directory 


e File type - the type by which the file is known in_ the 
directory 


e File version - the version number by which the file is known 
in the directory 
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RMS-11 operations construct and use file specification strings and 
file identifiers to specify files. These strings and identifiers 
include: 


e User-provided file specification strings 
e Expanded file specification strings 

e Resultant file specification strings 

e File, directory, and device identifiers 


This section discusses these strings and identifiers as they are used 
for nonwildcard operations; wildcard use is described in Section 3.8. 


For a CREATE, ENTER, ERASE, OPEN, PARSE, REMOVE, or RENAME operation, 
your program specifies two strings to be used in generating a full 
file specification: 


e A file specification string, called the file string (your 
program specifies the address of the file string in the l-word 
FNA field of the FAB and the length of the string in the 
l-byte FNS field of the FAB) 


e A default file specification string, called the default string 
(your program specifies the address of the default string in 
the l-word DNA field of the FAB and the length of the string 
in the l-byte DNS field of the FAB) 


The operation routine uses these two strings to form an internal 
merged file specification string, called the merged string. The 
Operation initially forms the merged string as follows: 


e It begins by taking available elements from the file string. 


e It then supplies missing elements from the default string (if 
they are available there). The operation (when it completes) 
returns masks describing the results of this merge in the 
l-word FNB field of the NAM block (if you supplied a NAM block 
for the operation). 


If elements are still missing from the merged string, the operation 
next adds the following elements: 


@e Device - If the logical channel specified in the LCH field of 
the FAB is already assigned to a device, that device is used; 
otherwise the device SY: is used. 


e Directory - The task's current directory is used. 
e File name, type, and version - Nulls are used. 


If the operation is the PARSE operation, the merged string is 
complete. If you provided a NAM block, the PARSE operation returns 
the device identifier in the 2-word DVI field of the NAM _ block; if 
you provided an expanded string buffer, the PARSE operation returns 
the expanded string in the expanded string buffer (whose address is in 
the l-word ESA field of the NAM block). (Note that the device 
specification in an expanded string has usually been translated to the 
specification for a physical device.) 
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An operation other than PARSE continues by examining the FBSFID mask 
in the FOP field of the FAB. If the FBSFID mask is set, the operation 
adds the following elements: 


e Device - If a device identifier is given in the NAM block, 
that device overrides the device in the merged string and the 
device specification is deleted from the merged string. 


@e Directory - If a directory identifier is given in the NAM 
block, that directory overrides the directory in the merged 
string and the directory specification is deleted from the 
merged string. 


e File identifier - If a file identifier is given in the NAM 
block and if the operation is ERASE or OPEN, that file 
overrides the directory, file name, type, and version in the 
merged string and the specifications for those elements are 
deleted from the merged string. 


The merged string is then copied to the expanded string buffer (if you 
supplied one) as described for the PARSE operation above. The merged 
string plus applicable identifiers are called the fully qualified file 
specification, and define the file upon which the operation will be 
performed. 


The device, directory, and file identifiers for the file are returned 
in the NAM block (if you supplied one). These identifiers can be used 
as input to subsequent directory and file operations to speed 
processing by eliminating directory and file lookups. 


Note that a complete file specification is relevant only to a disk 
file, The directory specification is not relevant for ANSI magtape 
files; only the device specification is relevant for a file on a 
unit-record device. Irrelevant elements are not processed, and appear 
in the expanded string only if your program provides them in the file 
string or default string. 


NOTE: NULL, 0, OR -1 VERSION NUMBER 


If the version specification has not 
been deleted and is null, 0, or -l, it 
will later be replaced with the version 
number of the target file. 


A version number of -l identifies the 
target file as the (otherwise) specified 
file with the lowest version number; a 
version number of -1l is illegal for a 
CREATE or ENTER operation, or for the 
new file specification for a RENAME 
operation. 


For an ERASE, OPEN, REMOVE, or RENAME 
(old specification) operation, a null or 
0 version number specifies the target 
file as the (otherwise) specified file 
with the highest version number. 


For a CREATE, ENTER, or RENAME (new 
specification) operation, a null or 0 
version number specifies that the 
operation is to create a new entry whose 
version number is one greater than the 
highest-numbered version of the 
(otherwise) specified file. 
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3.4 PRIVATE BUFFER POOLS 


Many RMS-1l operations require space from a buffer pool. A directory 
or file operation (except CLOSE, DISPLAY, or EXTEND) allows your 
program to specify a private buffer pool. Your program specifies the 
address of the pool in the l-word BPA field of the FAB; it specifies 
the size (in bytes) of the pool in the l-word BPS field of the FAB. 


The CLOSE operation returns (in the BPA and BPS fields) the address 
and size of the private buffer pool (if any) specified for the CREATE 
or OPEN operation that opened the file; until the file is closed, the 
pool is dedicated to the open file and must not be used for other 
purposes. 


If your program does not specify a private buffer pool, the operation 
uses the central buffer pool (which your program declares using 
pool-declaration macros); if your program specifies a private buffer 
pool, the operation uses that pool. 

The CLOSE, DISPLAY, and EXTEND operations, and all stream, record, and 


block operations use the pool specified by the CREATE or OPEN 
operation that opened the file. 


3.5 COMPLETION STATUS 
A directory or file operation returns a completion status code in the 


l-word STS field of the FAB, and a completion status value in the 
l-word STV field of the FAB. 


3.6 DIRECTORY OPERATIONS 


RMS-11 directory operations affect only directory entries (not the 
contents of files). The directory operations are: 


e ENTER: create a directory entry 

@ REMOVE: delete a directory entry 

@ RENAME: replace a directory entry 

e PARSE: analyze a file specification 
e SEARCH: search directories 


The next sections provide an overview of the directory operations 
(except for the SEARCH operation, which is discussed in Section 3.8). 


3.6.1 ENTER Operation 


A file specified as temporary when it was created has no directory 
entry; a file also has no directory entry if the entry has been 
deleted by the REMOVE operation. 


Your program can use the ENTER operation to create a directory entry 
for ae file; this makes it possible for your program (and other 
programs) to specify the file to RMS-11 by its file specification. 


The ENTER operation uses the device and directory elements of the 


fully qualified file specification to determine the target directory; 
it then creates an entry in that directory using the file name, type, 
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and version elements of the fully qualified file specification, and 
the file identifier specified in the NAM block. 


3.6.2 REMOVE Operation 


Your program can delete the directory entry for a file by using the 
REMOVE operation; this does not affect either the existence of the 
File or the file contents, but only removes the path to the file. 


The device and directory elements of the fully qualified file 
specification specify the target directory; the file name, type, and 
version elements of the fully qualified file specification identify 
the entry to be removed from the directory. 


3.6.3 RENAME Operation 


Your program can replace the directory entry for a file by using the 
RENAME operation. The fully qualified file specification for the new 
directory entry must not specify a new device for the file, but 
otherwise it can specify elements different from the old file 
specification: directory, file name, file extension, and file version 
number. 


If you do not specify a device, the device associated with the old 
file specification is used. 


For both the old and new directory entries, the RENAME operation uses 
the device and directory elements of the fully qualified file 
specification to determine the target directory; it uses the file 
name, type, and version elements of the fully qualified file 
specification to identify the entry to be removed or created. 


3.6.4 PARSE Operation 
Your program can use the PARSE operation to analyze a file 
specification, or to prepare for a series of wildcard operations 


(described in Section 3.8). The results of the PARSE operation are 
described in detail in Section 3.3. 


3.7 FILE OPERATIONS 


RMS-1l file operations affect files as whole entities (but not 
individual records or blocks in files). The file operations are: 


@ CREATE: create a file (and a corresponding directory entry) 
and open the file for processing 


@ OPEN: open an existing file for processing 
e DISPLAY: write file information to control blocks 


e ERASE: delete file contents (records or blocks) and remove 
directory entry 
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e EXTEND: increase the allocation for a file 
@e CLOSE: close an open file 


The next sections discuss file operations. 


3.7.1 CREATE Operation 


The CREATE operation creates a new file and opens it for processing; 
unless the file is specified as a temporary file, the CREATE operation 
also creates a directory entry for the file. 


The CREATE operation uses the device and directory elements of the 
fully qualified file specification to determine the target directory; 
it then uses the file name, type, and version of the fully qualified 
file specification to form the entry in that directory. 


3.7.2 OPEN Operation 


Your program can establish an access path to a file by using the OPEN 
operation. This makes file information available to your program, and 
enables your program to use the following operations for the file: 


e DISPLAY operation (to make more file information available to 
your program). 


@e EXTEND operation (to allocate more space for the file). 

@e CONNECT operation (to establish a path to file records or 
blocks). The CONNECT operation enables your program to use 
other stream operations and either record operations or block 
operations. 


e CLOSE operation (to release resources committed to the open 


file). The CLOSE operation terminates the access path 
established by the CREATE or OPEN operation that opened the 
file. 


3.7.3 DISPLAY Operation 


If your program uses the OPEN operation to open a file, but does not 
provide control blocks and buffers for all the information that the 
OPEN operation can return, you may want to use the DISPLAY operation 
to obtain additional information while the file is open. 


3.7.4 ERASE Operation 


Your program can erase the contents of a file by using the ERASE 
operation, and (optionally) remove its directory entry. 


Unless your program provides a file identifier in the NAM block and 
sets the FBSFID mask in the l-word FOP field of the FAB, the ERASE 
operation also removes the specified directory entry for the file. 
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The ERASE operation uses the fully qualified file specification to 
determine the target file. If the operation removes the directory 
entry, it uses the device and directory elements of the fully 
qualified file specification to determine the target directory, and 
the file name, type, and version elements to determine the entry to be 
removed. 


3.7.5 EXTEND Operation 


Your program can increase the allocation for an open file by using the 
EXTEND operation. Note that RMS-11 automatically extends the file 
allocation when it needs more space; you can use the EXTEND operation 
to make large extensions (avoiding repeated automatic extensions) or 
exact extensions (avoiding wasteful automatic extensions). 


3.7.6 CLOSE Operation 


Your program can close an open file by using the CLOSE operation. 
This releases task and system resources (other than the file itself) 
and makes those resources available for other uses. 


3.8 WRITING WILDCARD LOOPS 


You can include wildcard characters in an RMS-1ll file specification 
and use the PARSE and SEARCH operations to identify files that match 
the wildcard specification. This allows you to program a wildcard 
loop that successively (and selectively, if you wish) processes files 
matching the wildcard specification. 


An advantage of RMS-11 wildcarding over system wildcard commands is 
that your processing can be selective. For example, if you use a 
system wildcard command to rename a group of files, the entire group 
is renamed; if you use a wildcard loop in a program, the program can 
fully examine information about each file and even the contents of 
each file to decide whether to rename it. 


The next three sections show: 


e The structure of a wildcard loop and the behavior of directory 
and file operations in the loop 


e How to write a wildcard loop that nonselectively uses’ the 
ERASE, REMOVE, or RENAME operation on Successive matching 
files 


e How to write a wildcard loop that selectively performs 
directory and file operations on successive matching files 


3.8.1 Introduction to Wildcarding 


This discussion assumes that you want to write a program loop that 
uses a wildcard input file specification, and that you want to use the 
same control blocks (FAB and NAM block) for all operations associated 
with the wildcard loop. 
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A series of wildcard operations can be viewed as having four steps: 
1. Initializing for wildcarding 
2. Finding the next matching file 
3. Operating on the found file 
4. Ending wildcarding 


The next sections discuss these steps. 


3.8.1.1 Initializing for Wildcarding - The PARSE operation 
initializes control blocks (FAB and NAM block) for wildcard 
operations. Place the SPARSE macro before the wildcard loop in your 
program. 


The PARSE operation sets the NBSWCH mask in the l-word FNB field of 
the NAM block to show that wildcard operations are in progress. (Your 
program must clear the NBSWCH mask if it will not perform SEARCH 
operations after a PARSE operation.) 


The PARSE operation also forms a match-pattern in the expanded string 
buffer (whose address is in the l-word ESA field of the NAM block); 
this match-pattern is used by subsequent wildcard SEARCH operations. 


A series of SEARCH operations requires a NAM block that specifies both 
expanded string and resultant string buffers. (The resultant string 
buffer is specified in the l-word RSA field of the NAM block.) Your 
program must not alter the expanded string, the resultant string, or 
other NAM block contents between the PARSE operation and the end of 
the subsequent series of SEARCH operations. 


3.8.1.2 Finding the Next Matching File - The SEARCH operation finds 
the next file (if any) that matches the wildcard input file 
specification. (If the SEARCH operation cannot find another matching 
file, wildcarding ends; see Section 3.8.1.4.) 


The SEARCH operation returns a fully qualified file specification in 
the resultant string buffer, along with device, directory, and file 
identifiers for the found file. 


The SEARCH operation in your wildcard loop can either be explicit 
(your loop contains the SSEARCH macro) or, for some operations, 
implicit (RMS-1l automatically performs the SEARCH operation). If you 
use the explicit SEARCH operation, place the SSEARCH macro inside the 
loop but before other operation macros. 


If you use an ERASE, REMOVE, or RENAME (old FAB) operation in the loop 
with the FBSFID mask in the 1l-word FOP field of the FAB cleared, 
RMS-11 implicitly performs a SEARCH operation (to find the next 
matching file) before performing the ERASE, REMOVE, or RENAME 
Operation. This allows your wildcard loop to omit the SSEARCH macro. 
(If the implicit SEARCH operation cannot find another matching file, 
wildcarding ends; see Section 3.8.1.4.) 
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3.8.1.3 Operating on the Found File - A number of directory and file 
Operations are wildcard-transparent in the sense that they preserve 
both wildcard context information and information about the last-found 
file. This means that your program can use the operations within a 
wildcard loop without changing the wildcard context; the series of 
wildcard operations is continuable. 


The wildcard-transparent operations are CLOSE, DISPLAY, and EXTEND, 
and (if the FBSFID mask in the l-word FOP field of the FAB is set) 
ERASE, OPEN, REMOVE, and RENAME (old FAB). 


3.8.1.4 Ending Wildcarding - A series of wildcard operations (using a 
specific FAB and NAM block) ends when a directory or file operation 
discards wildcard context information or when your program clears’ the 
NBSWCH mask in the l-word FNB field of the NAM block. 


Typically, the operation that ends wildcarding is a SEARCH operation 
that cannot find another matching file. It returns the ERSNMF 
completion status code and clears the NBSWCH mask in the 1l-word FNB 
field of the NAM block. 


If your program exits from a wildcard loop before the SEARCH operation 
fails to find a matching file, the NBSWCH mask in the l-word FNB field 
of the NAM block is still set, and your program must clear it. 


Executing the PARSE operation during a wildcard series ends that 
series and initializes control blocks for a new series. 


Executing a CREATE or ENTER operation, or an OPEN operation with the 
FBSFID mask in the 1l-word FOP field of the FAB cleared, ends the 
wildcard series for that FAB. 


3.8.2 Nonselective ERASE, REMOVE, or RENAME Wildcard Operations 


You can write a wildcard loop that performs nonselective ERASE, 
REMOVE, or RENAME operations on successive matching files, where 
RMS-11l implicitly performs a SEARCH operation before each ERASE, 
REMOVE, or RENAME operation. 


To do this, do the following: 


1. Use the PARSE operation to initialize control block fields 
for wildcarding. 


2. Clear the FBSFID mask in the l-word FOP field of the FAB (for 
the RENAME operation, the old FAB). This causes the ERASE, 
REMOVE, or RENAME operation to perform an implicit SEARCH 
operation before performing its own processing. 


3. Use the ERASE, REMOVE, or RENAME operation to operate on the 
next matching file. 


4. Examine the STS field of the FAB. If it contains the ERSNMF 
completion status code, there was not another matching file; 
in that case, go to step 7. 


5. Perform other in-loop processing (such as reporting the file 
specification of the erased, removed, or renamed file). 
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6. Go to step 2. 


7. The wildcard series is finished; continue with other 
processing. 


The following program segment illustrates this procedure, performing 
the ERASE operation. In the program segment, FABADR is a label giving 
the address of the FAB for the operations, and RO is used (for the 
SSTORE and SCOMPARE macros) to contain the address of the FAB. 


SPARSE #FABADR ;Set up for wildcarding 
LOOP: MOV #FABADR, RO ;FAB address to RO 

SOFF #FBSFID,FOP,RO ;Use implicit search 

; (FBSFID off) 

SERASE #FABADR ;Try to erase next file 

SCOMPARE #ERSNMF,STS,RO ;Was there a matching file? 

BEQ DONE ;No more matching files 

a ;Other in-loop processing 

BR LOOP ;On to next matching file 
DONE: & 4 ;Continue with other 


; processing 


3.8.3 Selective Wildcard Operations 


You can write a wildcard loop that performs directory and file 
operations on selected matching files, where your program explicitly 
performs a SEARCH operation at the beginning of each iteration of the 
loop. To do this, do the following: 


1. Use the PARSE operation to initialize control block fields 
for wildcarding. 


2. Use the SEARCH operation to obtain information about the next 
file that matches the wildcard specification. 


3. Examine the STS field of the FAB. If it contains the ERSNMF 
completion status code, there was not another matching file; 
in that case, go to step 6. 


4. Perform directory and file operations on the found file. If 
ERASE, OPEN, REMOVE, or RENAME operations are included, be 
Sure the FBSFID mask in the l-word FOP field of the FAB (for 
the RENAME operation, the old FAB) is set. 


Do not perform CREATE, ENTER, or PARSE operations, or OPEN 
operations with the FBSFID mask cleared; these operations 
end wildcarding. 


Do not perform ERASE, REMOVE, or RENAME operations with the 
FBSFID mask cleared; these operations perform an implicit 
SEARCH operation, advancing to the next matching file. 

5. Go to step 2. 


6. The wildcard series is finished; continue with other 
processing. 
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The following program segment illustrates the procedure, performing 
the ERASE operation on selected files. In the program segment, FABADR 
is a label giving the address of the FAB for the operations, and RO is 
used (for the SCOMPARE macro) to contain the address of the FAB. 


SPARSE #FABADR ;Set up for wildcarding 
LOOP: S SEARCH #FABADR ;Find next matching file 
MOV #FABADR, RO ;FAB address to RO 
SCOMPARE #ERSNMF,STS,RO ;Any more matching files? 
BEQ DONE ;No more matching files 
bya? _ 3Decide whether to delete 
; file (if so, Z-bit on) 
BNE NOOP ;Don't delete file 
MOV #FABADR,RO ;FAB address to RO 
SSET #FBSFID,FOP,RO ;Explicit SEARCH already done 
SERASE #FABADR ;Erase file contents 
NOOP: se oa ie ;Other in-loop processing 
BR LOOP ;On to next matching file 
DONE: oes ;Continue with other 


; processing 
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PROCESSING RECORDS AND BLOCKS 


This chapter describes use of RMS-1ll stream, record, and block 
operations; its major sections are: 


e Synchronous and asynchronous operations 
e Completion status 

e Streams 

@e Record processing 


e Block processing 


4.1 SYNCHRONOUS AND ASYNCHRONOUS OPERATIONS 


An RMS-l1l stream, record, or block operation executes either 
synchronously or asynchronously. 


4.1.1 Synchronous Operations 


If an operation executes synchronously, execution control is not 
returned to your program until the operation has completed; your 
program is idle during the operation's execution. To specify 
synchronous operation for a stream, record, or block operation, clear 
the RBSASY mask in the l-word ROP field of the RAB. 


4.1.2 Asynchronous Operations 


If an operation executes asynchronously, execution control may be 
returned to your program before the operation has completed; this 
allows your program to continue executing during the operation's 
execution. To specify asynchronous operation for a stream, record, or 
block operation, set the RBSASY mask in the l-word ROP field of the 
RAB. (You must also have specified the ASYN argument to the RABSB 
macro when you declared the RAB, and must select the asynchronous 
support modules when you task build your program.) 


Your program can, for example, specify an asynchronous write operation 
and continue its processing even while the file processor is waiting 
for access to the device. 
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Only one operation (either synchronous or asynchronous) at a time may 
be active for a stream. Your program must make sure that an 
asynchronous operation has completed either by using’ the WAIT 
Operation or by using completion routines to set user-defined flags. 


During processing, RMS-1l guards against illegal interleaving of 
Operations on the same file as follows: 


@ A file operation begins by verifying that no record operation 
is in progress for the target file. 


e A record operation begins by verifying that no file operation 
is in progress for the target file. 


e If a synchronous operation detects that it is executing within 
an asynchronous operation's completion handler, it verifies 
that no other record operation is in progress for the target 
file. 


If one of these verifications fails, the operation returns the ERSACT 
completion in the STS field of the FAB or RAB. 


If your program attempts an operation using a FAB or RAB that is 
already in use by another operation, the attempted operation returns 
the fatal completion ERSACT in RO (because the STS field of the FAB or 
RAB belongs to the other operation). 


If your program attemps a WAIT operation within the completion handler 
for an asynchronous operation, the attempted operation returns the 
fatal completion ERSAST in RO (because otherwise a deadlock could 
occur). 


4.2 COMPLETION STATUS 


A stream, record, or block operation returns a completion status code 
in the l-word STS field of the RAB; it may also return a completion 
status value in the l-word STV field of the RAB. 


4.3 STREAMS 


A stream is a path from your program to the data in ae file. The 
CONNECT operation establishes a stream; for the CREATE or OPEN 
operation that opened the file, your program specified either record 
access or block access. 


If it specified record access, the stream iS a record stream and 
supports only stream operations and record operations; Oe es 
specified block access, the stream is a block stream and supports only 
stream operations and block operations. 


For the CONNECT operation, your program specifies the FAB for the file 
(in the 1l-word FAB field of the RAB), and the CONNECT operation 
returns an internal stream identifier (in the l-word ISI field of the 
RAB). All stream, block, and record operations (except CONNECT) 
identify the file using the internal stream identifier; the 
DISCONNECT operation terminates the stream, and clears the internal 
stream identifier. 
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4.4 RECORD PROCESSING 


This section describes use of RMS-1ll_ record processing. Its 
Subsections are: 


e Record streams: the paths from your program to file records 
e Record context: the "current location" of a stream in a file 
e Record access modes: the ways your program can access records 


e Record buffers: the locations of records in your program's 
space 


e Locate mode: a way of speeding record processing 
e Stream operations: stream operations for a record stream 


@e Record operations: operations that access records 


4.4.1 Record Streams 


A record stream is a path from your program to the records ina file. 
Your program establishes a record stream when it uses the CONNECT 
Operation to connect a stream to a file (opened for record access by 
an earlier CREATE or OPEN operation). A record stream supports stream 
operations and record operations, but not block operations. 


If the target file for a stream is a relative or indexed file, your 
Program can establish more than one stream for the file; if, in 
addition, your program specifies access sharing, more than one task 
can establish streams for the file. 


4.4.2 Record Context 


A record stream has a record context, which consists of a 
current-record context and a next-record context. Some record 
Operations use the current record or next record as the target for the 
Operation; some stream and record operations change the 
current-record context, the next-record context, or both. 


The notion of "following record" is important to record context 
because the next-record context is often established as the record 
"following" the current record. The precise meaning of "following 


record" depends on the file organization: 


e In a sequential file, the record following a given record is 
the one immediately following it in physical sequence. 


e Ina relative file, the record following a given record is the 
one in the first higher-numbered cell that contains a record. 


e In an indexed file, a record follows another only with respect 
to an index; each index imposes an order on the file records. 
The record following a given record (under a given index) is 
the record whose record key is the smallest in the file that 
is greater than the record key of the given’ record; among 
records having identical record keys, a record written later 
follows a record written earlier. 
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Note that although an operation may establish the next-record context, 
that context is not evaluated until another operation uses it. For 
example, if your program connects a stream to a relative file that 
contains records only in cells 5 and 10, a sequential access GET 
Operation returns the record in cell 5. and establishes both 
current-record and next-record context; if another stream or task 
then inserts a record in cell 7 before your program executes a_ second 
sequential access GET operation, that GET operation returns the new 
record (cell 7), even though the record did not exist when the 
next-record context was established. 


4.4.3 Record Access Modes 


The record operations FIND, GET, and PUT allow your program to specify 
a record access mode (in the 1l-byte RAC field of the RAB); the record 
access mode determines the target record for the operation. The 
record access modes are: 


e Sequential access 
@® Key access 
e RFA access 


The next sections discuss these access modes. 


4.4.3.1 Sequential Access - Your program specifies sequential access 
by setting the RBSSEQ code in the l-byte RAC field of the RAB. A 
sequential access FIND or GET operation has as its target the next 
record. (Exception: a sequential access GET operation that 
immediately follows any FIND operation has as its target the current 
record, which is the record found by the FIND operation.) 


The target of a sequential access PUT operation depends on the _ file 
organization, as follows: 


e For a sequential file, a series of Sequential access put 
Operations must begin with the next-record context at the 
end-of-file. The series of PUT operations adds new records at 
the end-of-file. 


e For a relative file, a series of sequential access PUT 
Operations must begin with the next-record context set such 
that the first cell examined is empty (unless the RBSUIF mask 
in the l-word ROP field of the RAB is set). The series of PUT 
Operations adds new records in successive cells; if a 
nonempty cell is encountered, the PUT operation returns the 
ERSREX completion (unless the RBSUIF mask is set, in which 
case the existing record is overwritten). 


e For an indexed file, a series of sequential access PUT 
operations does not depend on the next-record context; 
however, a PUT operation in the series returns the ERSSEQ 
completion if the value of the record primary key for the 
Operation is less than the value of the record primary key for 
the preceding PUT operation. 


A sequential access FIND or GET operation sets the current-record 
context to the target record, and sets the next-record context to the 
record following the target record. Sequential access PUT operations 
leave both the current-record and next-record contexts undefined. 
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This targeting and context setting means, generally speaking, that a 
series of sequential access operations operates on successive records. 
Specifically, series of sequential access operations result as 
follows: 


e A series of sequential access FIND operations sets the stream 
context to successive records. 


e A series of sequential access GET operations reads successive 
records. 


e A series of sequential access PUT operations writes successive 
records (for an indexed file, possibly interspersed with 
existing records). 


e A series of paired sequential access FIND and _ sequential 
access GET operations reads successive records. 


4.4.3.2 Key Access - Your program specifies key access by setting the 
RBSKEY code in the l-byte RAC field of the RAB. A key access FIND, 
GET, or PUT operation has as its target the record that your program 
specifies by specifying the key. For a relative file or for a 
sequential disk file with fixed-length records, your program specifies 
the key as a relative record number. Specify the relative record 
number in the l-word KBF field of the RAB and the key size as 0 or 4 
in the l-byte KSZ field of the RAB. 


For a FIND or GET operation for an indexed file, your program 
specifies the index of reference and a key buffer that contains the 
record key. Specify the index of reference in the l-byte KRF field of 
the RAB, the address of the key buffer in the l-word KBF field of the 
RAB, and the key size in the l-byte KSZ field of the RAB. 


A key access FIND or GET operation sets the current-record context to 
the record that is the target of the operation; a key access PUT 
operation leaves the current-record context undefined. 


A key access FIND or PUT operation does not affect the next-record 
context; a key access GET operation sets the next-record context to 
the record following the target record. 


The target of a key access FIND, GET, or PUT operation depends on the 
Operation and on the file organization: 


e For a relative file or for a sequential disk file with 
fixed-length records, the key is a positive integer and 
specifies the position of the record in the file. This key is 
the relative record number  (RRN) for the record; RRN l 
specifies the first record, and so forth. 


If your program sets the RBSKGT mask in the l-word ROP field 
of the RAB, a FIND or GET operation searches for a record 
whose RRN is greater than the given’ RRN; if it sets the 
RBSKGE mask in the l-word ROP field of the RAB, the operation 
searches for a record whose RRN is greater than or equal to 
the given RRN; if it sets neither of these masks, the 
Operation searches for a record with the given RRN. 
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Note that a FIND, GET, or PUT operation to a relative file or 
to a sequential disk file with fixed length records returns 
the RRN for the target record in the 2-word BKT field of the 
RAB. 


e For a FIND or GET operation to an indexed file, the key 
specifies a record in the file whose record key matches the 
given key. Your program specifies both the key to be matched 
and the file index; the key data type must agree with the key 
data type for the index (string, packed decimal, binary, or 
Signed integer). 


For a string key, your program specifies the portion of the 
key that must be matched. If the value in the l-byte KSZ 
field of the RAB is nonzero but is smaller than the record 
key, then only that smaller initial portion of the key must 
match. 


If your program sets the RBSKGT mask in the l-word ROP field 
of the RAB, a FIND: or GET operation searches for a record 
whose key is greater than the given key; if it sets the 
RBSKGE mask in the l-word ROP field of the RAB, the operation 
searches for a record whose key is greater than or equal _ to 
the given key; if it sets neither of these masks, the 
Operation searches for a record whose key exactly matches’ the 
given key. 


e For a PUT operation to an indexed file, the key (for each 


index) is in the record. The operation has no true target; 
the record is inserted at the proper place and each index is 
updated. 


This targeting and context setting means that although the target of 
the key access operation is a random (selected) record, the record 
context allows subsequent sequential access processing. Therefore 
your program can use key access to "jump" to a selected point ina 
file, then use Sequential access to process succesSive records. 


4.4.3.3 RFA Access - Your program specifies RFA access by setting the 
RBSRFA code in the l-byte RAC field of the RAB. An RFA access FIND or 
GET operation has as its target the record that your program specifies 
by RFA (record file address). (The FIND, GET, and PUT operations 
return the RFA for the target record; if your program saves the’ RFA, 
it can use RFA access for the record in subsequent FIND and GET 
operations.) Specify the RFA in the 3-word RFA field of the RAB. 


An RFA access FIND or GET operation sets the current-record context to 
the record that is the target of the operation. An RFA access FIND 
operation does not affect the next-record context; an RFA access’ GET 
operation set the next-record context to the record following the 
target record. 


This targeting and context setting means that although the target of 
the RFA access operation is a random (selected) record, the record 
context allows subsequent sequential access processing. Therefore 
your program can use RFA access to "jump" to a selected point ina 
file, then use sequential access to process successive records. 
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4.4.4 Record Buffers 


A PUT or UPDATE operation transfers a record from a record buffer (in 
your program's space) to a file; for a VFC record, the operation also 
transfers the fixed-length portion of the record from a_ separate 
record header buffer. Your program specifies the address of the 
record buffer in the l-word RBF field of the RAB and the size of the 
record in the 1l-word RSZ field of the RAB; for a VFC record, your 
program also specifies the address of the record header buffer in the 
l-word RHB field of the RAB. 


A GET operation transfers a record from a file to an RMS-1l internal 
I/O buffer and to a user buffer in your program's space. Your program 
specifies the address of the user buffer in the l-word UBF field of 
the RAB and its size in the l-word USZ field of the RAB. Along with 
the record, the GET operation returns the address of the record in the 
l-word RBF field of the RAB and its size in the l-word RSZ field of 
the RAB. 


For a VFC record, a GET operation also transfers the fixed-length 
portion of the record to a separate record header buffer in your 
program's space. Your program specifies the address of the record 
header buffer in the l-word RHB field of the RAB. 


Exception: if your program specifies locate mode for a GET operation, 
RMS-11 may not transfer the record to the user buffer; see the next 
section for a discussion of locate mode. 


4.4.5 Locate Mode 


The GET and PUT operations normally use RMS-11 internal I/0 buffers as 
intermediate storage between your program's buffers (record or user 
buffers) and the file. By specifying locate mode for a GET or PUT 
operation, your program requests RMS-11 to transfer records only 
between its I/O buffers and the file, thus saving time. Your program 
specifies locate mode by setting the RBSLOC mask in the l-word ROP 
field of the RAB. 


If your program specifies locate mode for a GET operation, RMS-11 may 
transfer the record only to its internal I/O buffer (but not to the 
user buffer). The GET operation routine decides whether to honor’ the 
locate-mode request or to transfer the record to the user buffer 
anyway; the operation returns the address and size of the retrieved 
record (informing your program of the record's location -- the user 
buffer or the I/0 buffer). 


If your program specifies locate mode for a PUT operation, RMS-11 
recognizes that the record may already be in its I/O buffer and if so 
transfers it to the file from there. 


Your program has (in the l-word RBF field of the RAB) the address of a 
location (in the I/O buffer if possible, otherwise in the user buffer) 


that is suitable for building the next record; this address is 
returned either by a previous locate-mode PUT operation or by an 
initial locate-mode CONNECT operation. Therefore, if you use the 


CONNECT operation for a stream that will use locate-mode PUT 
operations, your program must specify locate mode for the CONNECT 
operation, and must specify a user buffer (the address in the l-word 
UBF field of the RAB and the size in the l-word USZ field of the RAB). 


Note that specifying locate mode for a PUT operation has no effect 
unless the file is sequential, the access mode is sequential, and the 
record format is other than stream record format. 
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4.4.6 Stream Operations 


Stream operations affect stream context and I/O buffers (but not file 
records). The stream operations for a record stream are: 


@ CONNECT: establish a record stream 

@e FLUSH: write unwritten buffers for a stream 

@ FREE: free locked bucket for a stream 

e NXTVOL: set stream context to beginning of next volume 
@ REWIND: set stream context to beginning of current file 
@e WAIT: wait for completion of asynchronous operation 

@e DISCONNECT: terminate a record stream 


The next sections discuss these operations. 


4.4.6.1 CONNECT Operation - Your program uses the CONNECT operation 
to establish a record stream. (The stream is a record stream because 
your program specified record access for the CREATE or OPEN operation 
for the file.) 


The current-record context after a CONNECT operation is undefined; 
the next-record context is (by default) the first record in the file. 


For an indexed file, your program must specify an initial index of 
reference so that the record context is initialized properly. 


For a sequential file, your program can specify that the initial 
record context is to be at the end-of-file (instead of the beginning 
of the file); in that case, the next-record context after the 
operation is the end-of-file. 


For a sequential disk file, your program specifies the number of 
blocks in the I/0 buffer for the stream; for a relative or indexed 
file, your program specifies the number of I/O buffers for the stream. 


If the stream will use locate-mode PUT operations, your program must 
also specify locate mode and supply a user buffer. The CONNECT 
operation returns the address of a location suitable for building the 
first record to be output; see Section 4.4.5. 


4.4.6.2 FLUSH Operation - Your program can use the FLUSH operation to 
write any unwritten buffers for a stream (for example, to increase 
data integrity by ensuring that all changes have been written to the 
file); the FLUSH operation does not affect record context, except 
that the current-record context is undefined for a following TRUNCATE 
or UPDATE operation to a sequential file. 


Note one special case: if the file was opened for deferred writing, 
but not for write sharing, then the buffer may be controlled by 
another record stream and will not be written by the FLUSH operation. 
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4.4.6.3 FREE Operation -— Your program can use the FREE operation to 
free a locked bucket for a stream; the FREE operation does not affect 
stream context, except that the current-record context is undefined 
for a following DELETE, TRUNCATE, or UPDATE operation. 


4.4.6.4 NXTVOL Operation - Your program can use the NXTVOL operation 
to advance the context for a stream to the beginning of the next 
magtape volume. The current-record context after the operation is 
undefined; the next-record context is the first record of the new 
volume. 


4.4.6.5 REWIND Operation - Your program can use the REWIND operation 
to reset the context for a stream to the beginning-of-file or, for a 
multivolume magtape file, the beginning-of-volume (if it is not the 
first volume of the file). 


The current-record context after the operation is undefined; the 
next-record context is the first record in the volume (for a 
multivolume magtape file) or the file; for an indexed file, your 


program specifies the index of reference for the operation so that the 
stream context is initialized properly. 


4.4.6.6 WAIT Operation - When your program uses asynchronous 
Operation for a stream, it must eventually use the WAIT operation to 
suspend processing until the asynchronous operation has _ completed; 
the WAIT operation does not affect stream context. 


4.4.6.7 DISCONNECT Operation - Your program can use the DISCONNECT 
Operation to terminate a record stream, thus recovering the resources 
committed for the stream (primarily pool space). The DISCONNECT 
Operation also discards record context and the internal stream 
identifier. 


4.4.7 Record Operations 


Record operations affect stream context, buffers (I/O, user, and 
record), and file records. The record operations are: 


@e FIND: transfer a record from a file to an I/O buffer 


e GET: transfer a record from a file to an I/O buffer and to a 
user buffer 


@e PUT: transfer a record from a user buffer to a file 
e DELETE: remove a record from a file 
@ UPDATE: replace a record ina file 


@ TRUNCATE: remove the current record and all following records 
from a sequential file 


The next sections discuss these operations. 
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4.4.7.1 FIND Operation - Your program can use the FIND operation to 
transfer a record (or part of a record) from a file to an I/O buffer; 
the FIND operation does not transfer the record to a user buffer. 


Your program specifies an access mode (sequential, key, or RFA) for 
the FIND operation; Section 4.4.3 describes the target record and 
context-setting for the FIND operation (Section 4.4.3.1 for sequential 
access, 4.4.3.2 for key access, and 4.4.3.3 for RFA access). 


For a relative file or for a sequential disk file with fixed-length 
records, the FIND operation returns the relative record number (RRN) 
and the record file address (RFA) for the found record; for other 
files, the FIND operation returns only the RFA for the found record. 


4.4.7.2 GET Operation - Your program can use the GET operation to 
transfer a record from a file to an I/O buffer and to a user buffer 
(which your program specifies). 


Your program specifies an access mode (sequential, key, or RFA) for 
the GET operation; Section 4.4.3 describes the target record and 
context-setting for the GET operation (Section 4.4.3.1 for sequential 
access, 4.4.3.2 for key access, and 4.4.3.3 for RFA access). 


The GET operation returns the address and size of the retrieved 
record, along with its RFA; for a relative file or for a sequential 
disk file with fixed-length records, the GET operation also returns 
the RRN for the retrieved record. 


If your program specifies locate mode for the GET operation, it must 
also specify a user buffer; see Section 4.4.5. 


4.4.7.3 PUT Operation - Your program can use the PUT operation to 
transfer a record from a user buffer to an I/O buffer and to a file. 


Your program specifies an access mode (sequential or key) for the PUT 
operation; Section 4.4.3 describes the target record and 
context-setting for the PUT operation (Section 4.4.3.1 for sequential 
access, 4.4.3.2 for key access). 


Your program can specify that RMS-11 must honor bucket fill numbers. 


For an indexed file, your program can specify that each PUT operation 
in a series is part of a mass insertion; for a relative file, your 
program can specify that the PUT operation should overwrite the target 
record (if any). 


The PUT operation returns the RFA for the inserted record; for a 
relative file or for a sequential disk file with fixed-lentgh records, 
the PUT operation also returns the RRN for the inserted record. 


If your program specifies locate mode for the PUT operation, it must 
also specify a user buffer. The PUT operation returns the address of 
a location suitable for building the next output record; see Section 
4.4.5. 
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4.4.7.4 DELETE Operation - Your program can use the DELETE operation 
to remove a record from a relative or indexed file. The target of a 
DELETE operation is the current record. 


The current-record context after a DELETE operation is undefined; the 
next-record context is unchanged. 


For an indexed file, your program can specify that RMS-11 must use the 
fast-deletion procedure. However, this procedure is faster because it 
deletes only those alternate index pointers that it must; future 
retrieval operations may be slowed by the presence of undeleted 
alternate index pointers. 


4.4.7.5 UPDATE Operation - Your program can use the UPDATE operation 
to transfer a record from a user buffer to a file (overwriting the 
existing record). The target of the UPDATE operation is the current 
record, which is overwritten. 


The current-record context after an UPDATE operation is undefined; 
the next-record context is unchanged. 


Your program specifies the record buffer for the record to be inserted 
(and, for a VFC record, the VFC-header buffer). 


4.4.7.6 TRUNCATE Operation - Your program can use _ the TRUNCATE 
operation to remove the current record and all following records 
(through the end-of-file) from a sequential file. The current-record 
context after a TRUNCATE operation is undefined; the next-record 
context is the new end-of-file. 


4.5 BLOCK PROCESSING 


This section describes use of RMS-1l block processing. Its 
subsections are: 


e Block streams: the paths from your program to file blocks 
@e Block context: the "current location" of a stream ina file 
e Block access modes: the ways your program can access blocks 


e Block buffers: the locations of blocks in your’ program's 
space 


e Stream operations: stream operations for a block stream 


e Block operations: operations that access blocks 


4.5.1 Block Streams 


A block stream is a path from your program to the blocks in ae file. 
Your program establishes a block stream when it uses the CONNECT 
operation to connect a stream to a file (opened for block access by an 
earlier CREATE or OPEN operation). A block stream supports stream 
operations and block operations, but not record operations. 
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4.5.2 Block Context 


A block stream has a block context, which consists of a readable-block 
context and a writable-block context. The READ operation uses the 
readable-block as its target block; the WRITE operation uses’ the 
writable-block as its target block; block operations change both the 
readable-block and the writable-block contexts. 


For a disk file, your program can use the READ or WRITE 
read or write multiple blocks in a single operation. In that case, 
reading or writing begins at the readable block or the writable block 
(respectively), and continues through the number of blocks requested. 


operation to 


4.5.3 Block Access Modes 

specify a 
the block 

The block 


The block operations READ and WRITE allow your program to 
block access mode (in the 2-word BKT field of the RAB); 
access mode determines the target block for the operation. 
access modes are: 


e Sequential access 


e VBN access 


For a magtape file, your program can use either sequential block 
access or VBN access; however, the program must access one block at a 
time, and in sequential order (unless it uses the SPACE operation to 
position the magtape). 

The next sections discuss these access modes. 

4.5.3.1 Sequential Access - Your program specifies sequential block 
access by giving the value 0 in the 2-word BKT field of the RAB. A 


sequential access READ operation has as its target the readable block; 
it sets the readable-block context to the next-following unread block, 


and sets the writable-block context to the target block (first block 
read for that READ operation). 
A sequential access WRITE operation has as its target the writable 


block; it sets both the readable-block and writable-block contexts to 
the next-following unwritten block. 


This targeting and context setting has the following results: 


e A series of sequential access READ operations reads successive 


blocks. 

e A series of sequential access WRITE operations writes 
successive blocks. 

e A series of paired READ and WRITE operations updates 
successive blocks. 
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4.5.3.2 VBN Access — A VBN access READ or WRITE operation reads or 
writes blocks beginning with a virtual block that your program 
specifies. Specify the virtual block number in the 2-word BKT field 
of the RAB. 


Note that your program can use VBN access to move to a random position 
in a disk file, and then use sequential block access to process blocks 
sequentially from that point. 


4.5.4 Block Buffers 


Your program specifies a user buffer for the READ operation; the 
operation returns the address of the first-read byte and the number of 
bytes read. Specify the address of the user buffer in the l-word UBF 
field of the RAB and its size in the l-word USZ field of the RAB; the 
READ operation returns the address of the first-read byte in the 
l-word RBF field of the RAB and the number of bytes read in the l-word 
RSZ field of the RAB. 


Your program specifies the buffer containing the writable data for the 


WRITE operation. Specify the buffer address in the l-word RBF field 
of the RAB and its size in the l-word RSZ field of the RAB. 


4.5.5 Stream Operations 


Stream operations affect stream context and I/O buffers (but not file 
blocks). The stream operations for a block stream are: 


@e CONNECT: establish a block stream 

e FREE: free a locked block for a stream 

e WAIT: wait for completion of asynchronous operation 
e DISCONNECT: terminate a block stream 


The next sections discuss these operations 


4.5.5.1 CONNECT Operation - Your program uses the CONNECT operation 
to establish a block stream. (The stream is a block stream because 
your program specified block access for the CREATE or OPEN operation 
for the file.) 


After a CONNECT operation, both the readable-block and writable-block 
contexts are the first block in the file. 


4.5.5.2 FREE Operation - Your program can use the FREE operation to 
free a locked block for a stream; the FREE operation does not affect 
stream context. 
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4.5.5.3 WAIT Operation - When your program uses asynchronous 
operation for a stream, it must eventually use the WAIT operation to 
Suspend processing until the asynchronous operation has completed; 
the WAIT operation does not affect stream context. 


4.5.5.4 DISCONNECT Operation - Your program can use the DISCONNECT 
operation to terminate a block stream, thus recovering the resources 
committed for the stream. The DISCONNECT operation also discards 
block context and the internal stream identifier. 


4.5.6 Block Operations 


Block operations affect stream context, block buffers, and file 
blocks. The block operations are: 


@e READ: transfer blocks from a file to a block buffer 
e WRITE: transfer blocks from a block buffer to a file 
e SPACE: set block context for a magtape file 


The next sections discuss these operations. 


4.5.6.1 READ Operation - Your program can use the READ operation to 
transfer blocks from a file to a block buffer. Your program specifies 


an access mode (sequential or VBN) for the READ operation; Section 
4.5.3.1 describes sequential access; Section 4.5.3.2 describes VBN 
access. 


4.5.6.2 WRITE Operation - Your program can use the WRITE operation to 
transfer blocks from a block buffer to a file. Your program specifies 
an access mode (Sequential or VBN) for the WRITE operation; Section 
4.5.3.1 describes sequential access; Section 4.5.3.2 describes VBN 
access. 


Note that because the WRITE operation always writes to the file 
immediately, the FLUSH operation has no use for block access. 


4.5.6.3 SPACE Operation - Your program can use the SPACE operation to 
set block context for a magtape file; the context is moved forward or 
backward the specified number of blocks. After a SPACE operation, 
both the readable-block and writable-block contexts are the specified 
block. 


CHAPTER 5 


OPERATION MACRO DESCRIPTIONS 


This chapter describes RMS-1l operation macros and the operation 
routines they call. Each section of the chapter describes an 
operation macro and its corresponding operation. (For the SFIND, 
SGET, S$PUT, SREAD, and SWRITE macros, there is a separate description 
for each access method.) 
Each description is divided into the following parts: 

e FORMAT - the format for the macro and its parameters 


e CONTROL BLOCKS - the required and optional control blocks’ for 
the operation 


e OPTIONS - the options that you can select for the operation, 
and the control block fields and values that control the 
options 

e STREAM CONTEXT - the current-record and next-record contexts 
(for a record stream) or the readable-block and writable-block 
contexts (for a block stream) after the operation completes 


e RETURNED VALUES - the values that the operation routine 
returns in control block fields and buffers 


e CHECKLISTS - a list of the control block fields that you 
supply to specify options, anda list of the control block 
fields that contain returned values 

The operation macros are: 

@e SCLOSE - Close an open file 

e SCONNECT - Connect a record stream to an open file 

e SCREATE - Create a new file and open it for processing 

e SDELETE - Remove a record from a file 

@ SDISCONNECT - Disconnect a record stream 

e SDISPLAY - Write file data into control block fields 

e SENTER - Enter a file specification into a directory 

e SERASE - Erase an existing file 

e SEXTEND - Extend the allocation for an open file 


e SFIND - Set the stream context to a record ina file 
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e SFLUSH - Write any unwritten buffers for a stream 
@ SFREE - Unlock a bucket locked by a stream 
e SGET - Retrieve a record from a file 


e SNXTVOL - Set stream context to the beginning of the next 
magtape volume 


e SOPEN - Open an existing file 

e SPARSE - Write file data into a NAM block 
e SPUT - Insert a record into a file 

e SREAD - Read blocks from a file 


@ SREMOVE Delete a file specification from a directory 


e SRENAME - Rename an existing file 


e SREWIND - Set stream context to beginning-of-file 


e SSEARCH Search directories for a file specification 

e@ SSPACE - Move magtape block stream context forward or backward 
e STRUNCATE - Remove all following records from a file 

@e SUPDATE - Replace a record ina file 


e SWAIT - Wait for asynchronous completion for stream 


e SWRITE - Write blocks into a file 
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5.1 $CLOSE MACRO 


The SCLOSE macro calls the CLOSE operation routine to close an open 
file. 


FORMAT 
The format for the SCLOSE is: 
SCLOSE fabaddr[,ferraddr] [,sucaddr] ] 


where fabaddr is the address of the FAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 
You must supply a FAB for the CLOSE operation. 


If you supply a PRO block, the CLOSE operation reads its fields to 
obtain new owner and protection codes for the file. 


To supply XABs (ALL, DAT, KEY, PRO, and SUM_ blocks) for the CLOSE 
Operation, specify the address of the first XAB in the l-word XAB 
field of the FAB; specify the address of the next XAB (if any) in the 
l-word NXT field of each XAB; specify 0 in the NXT field of the last 
XAB. 


All KEY blocks must be together in the chain of XABs, and must be in 
ascending order (by the index reference number in the l-byte REF field 
of the KEY block); the index reference numbers need not be 
consecutive. 


All ALL blocks must be together in the chain of XABs, and must be in 
ascending order (by the area identifier in the l-byte AID field of the 
ALL block); the area identifiers need not be consecutive. 


Multiole DAT, PRO, or SUM XABs are illegal. 


OPTIONS 


Internal File Identifier 


The CLOSE operation reads the internal file identifier for the file 
from the l-word IFI field of the FAB. This identifier was written by 
the CREATE or OPEN operation when the file was opened. 


File Owner and Protection 


If you want to change the owner of the target file, specify the 
project (or group) portion of the owner code in the l-word PRJ field 
of the PRO block, and specify the programmer (or member) portion in 
the l-word PRG field of the PRO block; if you specify 0 for both 
these fields, the PRO block (including the PRO field) is ignored. 


If you want to change the file protection for the target file, specify 
the protection code in the 1l-word PRO field of the PRO block (and 
specify a nonzero value in the PRG or PRJ field); if you specify 0 in 
this field, the operating system uses its defaults. 
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Rewinding Magtape 

For a magtape file, if you want the magtape rewound when the file is 
closed, set the FBSRWC mask in the l-word FOP field of the FAB. Note 
that if the FBSRWC mask was set when the file was opened (by the 
CREATE or OPEN operation), setting the mask has no effect for the 
CLOSE operation. 

STREAM CONTEXT 

The CLOSE operation destroys stream context for any streams connected 


by the closing file (after writing any unwritten buffers for those 
streams). 


RETURNED VALUES 


Private Buffer Pool 

The CLOSE operation writes the address of the private buffer pool (if 
any) for the file in the l-word BPA field of the FAB; if the CLOSE 
operation clears the BPA field, the file had no private buffer pool. 
If the file had a private buffer pool, the CLOSE operation writes the 
size (in bytes) of the pool in the l-word BPS field of the FAB, or 
clears this field if the file did not use a private buffer pool. 


Internal File Identifier 


The CLOSE operation clears the l-word IFI field of the FAB. 


Completion Status and Value 


The CLOSE operation returns completion status in the l-word STS field 
of the FAB and returns a completion value in the l-word STV field of 
the FAB. Appendix A lists completion status symbols and values. 


CHECKLISTS 
Table 5-1 lists control block fields that are input to the CLOSE 


operation. Table 5-2 lists control block fields that are output by 
the CLOSE operation. 


Block Field 


Block Field 


AID 
NXT 
NXT 
FOP 


LET 
XAB 
REF 
NXT 
NXT 
PRG 
PRJ 
PRO 
NXT 


BPA 
BPS 
LEE 
STS 
STV 
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Table 5-1: CLOSE Input Fields 


Description 


Area number 

Next XAB address 

Next XAB address . 
File processing option mask 


FBS RWC Rewind magtape after closing file 


Internal file identifier 

XAB address 

Index reference number 

Next XAB address 

Next XAB address 

Programmer or member portion of file owner code 
Project or group portion of file owner code 
File protection code 


Next XAB address 


Table 5-2: CLOSE Output Fields 


Description 


Private buffer pool address 
Private buffer pool size (bytes) 
Internal file identifier 
Completion status code 


Completion status value 
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The SCONNECT macro calls the CONNECT operation routine to connect a 
record stream to an open file, and initialize the stream context. 
FORMAT 
The format for the SCONNECT is: 

SCONNECT rabaddr[,[erraddr] [,sucaddr] ] 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 
CONTROL BLOCKS 
You must supply a RAB for the CONNECT operation. 


You must supply a FAB for the CONNECT operation. 


OPTIONS 


File Identification 


Specify the address of the FAB in the l-word FAB field of the RAB, 
The CONNECT operation reads the internal file identifier for the file 
from the l-word IFI field of the FAB. 


I/O Buffers 


For a sequential disk file, specify the size (in blocks) of the RMS-11 
I/O buffer for the stream in the l-byte MBC field of the RAB; the 
largest legal value is 63. If you specify 0, the CONNECT operation 
uses a buffer of one block. For a relative file, an indexed file, or 
a sequential nondisk file, the CONNECT operation ignores the MBC 
field. 


For a relative or indexed file, specify the number of I/0 buffers’ for 
the stream in the l-byte MBF field of the RAB. For a sequential file, 
specify 0 in the MBF field. If you specify 0, the CONNECT operation 
uses the minimum number of buffers: one for a Sequential or relative 
file, or two for an indexed file. 


User Buffer (Locate Mode for Sequential File) 


If you are connecting to a sequential file, and if you intend to 
execute PUT operations in locate mode for the connected stream, then: 


e Specify the address of the user buffer in the l-word UBF field 
of the RAB. 


e Specify the size (in bytes) of the user buffer in the 1-word 
USZ field of the RAB. 


e Set the RBSLOC mask in the l-word ROP field of the RAB. 
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This assures proper handling of the first PUT operation for the 
stream. 


Key of Reference (Indexed File) 


For an indexed file, specify the key of reference in the 1l-byte KRF 
field of the RAB. This value specifies the index to be used in 
establishing initial record context: 0 for the primary index, 1 for 
the first alternate index, and so forth. 


Initial Stream Context (Sequential File) 


L£ you want to initialize the next-record context of a sequential file 
to the end-of-file, set the RBSEOF mask in the l-word ROP field of the 
RAB; if you do not set this mask, the CONNECT operation initializes 
the next-record context to the first record in the file (or to the 
end-of-file if the file is empty). 


Asynchronous Operation 


If you want to execute the CONNECT operation asynchronously, set the 
RBSASY mask in the 1l-word ROP field of the RAB; if you do not set 
this mask, the CONNECT operation executes synchronously. (Your 
program must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


STREAM CONTEXT 


For a record-access file, the current-record context after a CONNECT 
operation is undefined; the next-record context is the first record 
in the file (under the specified index for an indexed file), or the 
end-of-file, if the file is empty. 


For a block-access file, both the readable-block and writable-block 
contexts after a CONNECT operation are the first block in the file. 


RETURNED VALUES 


Internal Stream Identifier 


The CONNECT operation writes an internal stream identifier in the 
l-word ISI field of the RAB. Do not destroy this identifier; all 
other stream, record, and block operation routines read it. 


Record Buffer 


The CONNECT operation copies the value from the UBF field into the 
l-word RBF field of the RAB (the record address); this prepares the 
record buffer for your use in case the first record operation for the 
stream is a locate-mode PUT operation to a sequential file. 


RFA 


For block access, the CONNECT operation returns the logical 
end-of-file value in the 3-word RFA field of the RAB. The first two 
words of this field are the VBN in which the logical end-of-file 
occurs, and the third word is the offset of the first byte beyond the 
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logical end-of-file within that block. This logical end-of-file value 
is meaningful only for disk files. 
Completion Status and Value 
The CONNECT operation returns completion status in the 1l-word STS 
field of the RAB and returns a completion value in the l-word STV 
field of the RAB. Appendix A lists completion status symbols’ and 
values. 
CHECKLISTS 
Table 5-3 lists control block fields that are input to the CONNECT 
operation. Table 5-4 lists control block fields that are output by 
the CONNECT operation. 

Table 5-3: CONNECT Input Fields 


Block Field Description 


FAB IFI Internal file identifier 

RAB FAB FAB address 

RAB KRF Key of reference 

RAB MBC Multiblock count 

RAB MBF Multibuffer count 

RAB ROP Record processing option mask 


RBSASY Asynchronous operation 
RBSEOF Position to end-of-file 
RBSLOC Locate mode 
RAB UBF User buffer address 
RAB USZ User buffer size (bytes) 
Table 5-4: CONNECT Output Fields 


Block Field Description 


RAB ISI Internal stream identifier 
RAB RBF Record buffer address 

RAB RFA End-of-file address 

RAB STS Completion status code 

RAB STV Completion status value 
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5.3 $CREATE MACRO 


The SCREATE macro calls the CREATE operation routine to create a new 
file and open it for processing. 


FORMAT 
The format for the SCREATE is: 
SCREATE fabaddr[,[erraddr] [,sucaddr] } 


where fabaddr is the address of the FAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 
You must supply a FAB for the CREATE operation. 


If you supply a NAM block, the CREATE operation reads its fields to 
obtain the expanded string buffer, and writes identifiers in its 
fields. 


To supply a NAM block for the CREATE operation, specify the address of 
the NAM block in the l-word NAM field of the FAB. 


Each ALL block that you supply defines one area in the created file, 
and you can place the area at a specific location. If you supply no 
ALL blocks, the file has one area; you define this area in the _ FAB, 
but you cannot place the area at a specific location. You cannot 
supply more than one ALL block for a sequential or relative file. 


Each KEY block that you supply defines one index for the created file. 
You must supply at least one KEY block for an indexed file; you 
cannot supply KEY blocks for a relative or sequential file. 


If you supply a PRO block, the CREATE operation reads its fields to 
obtain the protection for the file. 


Tc supply XABs (ALL, DAT, KEY, PRO, and SUM blocks) for the CREATE 
operation, specify the address of the first XAB in the l-word XAB 
field of the FAB; specify the address of the next XAB (if any) in the 
l-word NXT field of each XAB; specify 0 in the NXT field of the last 
XAB. ; 


All KEY blocks must be together in the chain of XABs, and must be in 
ascending order (by the index reference number in the l-byte REF field 
of the KEY block); the index reference numbers must be consecutive 
beginning with 0. 


All ALL blocks must be together in the chain of XABsS, and must be in 
ascending order (by the area identifier in the l-byte AID field of the 
ALL block); the area identifiers must be consecutive beginning with 
0. 


Multiple DAT, PRO, or SUM XABs are illegal. 


Note that if the LAN field of a KEY XAB is 0, RMS-11 will use the area 
specified in the IAN field for the lowest level index for that index. 
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OPTIONS 


File Specification 


The CREATE operation constructs the full file specification from the 
file string, the default string (which contributes only elements not 
Present in the file string), and RMS-ll defaults (which contribute 
elements not present in either the file string or the default string). 


RMS~1ll defaults are: 


@e Device -- The device to which the specified logical channel is 
assigned, or SY: if the specified logical channel is not 
assigned to any device. 


e Directory -- The current directory for the task. 
e Name, type, version -- Defaulted to null. 
The file string and the default string must not contain wildcards. 


Svecify the address of the file string in the l-word FNA field of the 
FAB. Specify the size (in bytes) of the file string in the 1l-byte FNS 
field of the FAB; if you specify 0 in the FNS field, the CREATE 
operation uses no file string. 


Specify the address of the default string in the l-word DNA field of 
the FAB. Specify the size (in bytes) of the default string in the 
l-byte DNS field of the FAB; if you specify 0 in the DNS field, the 
CREATE operation uses no default string. 


I= you set the FBSFID mask in the l-word FOP field of the FAB and 
supply a NAM block, the CREATE operation reads the device identifier 
from the 2-word DVI field of the NAM block; if this value is nonzero, 
the specified device overrides the device in the merged string. 


In the same circumstance, the CREATE operation reads the directory 
identifier from the 3-word DID field of the NAM block; if this value 
1S nonzero, the specified directory overrides the directory in the 
merged string. 


Expanded String Buffer 


If you want the CREATE operation to return the expanded string for the 
created file, provide a buffer for the string. Specify the address of 
the expanded string buffer in the l-word ESA field of the NAM. block 
and its size (in bytes) in the l-byte ESS field of the NAM block; if 
you specify 0 in the ESS field, the CREATE operation does not- return 
the expanded string. 


Supersession of Existing File 


If you want to create a file that supersedes an existing file with the 
same specification, set the FBSSUP mask in the l-word FOP field of the 
FAB; if you do not set the FBSSUP mask, and you specify a file that 
already exists, the CREATE operation returns an error completion and 
does not create the new file. 
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Temporary or Marked-for-—Delete File 


If you want the created file to be a temporary file (one that has no 
directory entry), set the FBSTMP mask in the l-word FOP field of the 
FAB; if you do not set the FBSTMP mask, the created file has a 
directory entry. 


If you want the created file to be deleted when it is closed, set the 
FBSMKD mask in the l-word FOP field of the FAB; this causes the 
operating system to delete the file when it has no accessing programs. 
If you do not set the FBSMKD mask, the created file is not marked for 
deletion. 


If you want the created file to be a temporary file that is marked for 
deletion, set the FBSTMD mask in the l-word FOP field of the FAB; the 
FBSTMD mask includes the bits for both the FBSTMP and the FBSMKD 
masks. 


File Protection 


Specify the protection for the created file in the l-word PRO field of 
the PRO block; if you supply no PRO block, the operating system uses 
its default file protection. 


File Organization 


Specify a file organization code in the l-byte ORG field of the FAB. 
The symbols for file organization codes are: 


FBSIDX Indexed file organization 
FBSREL Relative file organization 
FBSSEQ Sequential file organization 


Record Format 


Specify the record format code in the l-byte RFM field of the FAB. 
The symbols for record format codes are: 


FBSFIX Fixed-length record format 
FBSSTM Stream record format 

FBSUDF Undefined record format 
FBSVAR Variable-length record format 
FBSVFC VEC record format 


If you specify VFC record format (FBSVFC code in the RFM field), 
specify the size (in bytes) of the VFC header field in the l-byte FSZ 
field of the FAB; if you specify 0, the CREATE operation uses’ the 
value 2. 


Blocked Records 


If you are creating a sequential disk file, and if you want the file 
to contain blocked records (records that cannot span _ block 
boundaries), set the FBSBLK mask in the l-byte RAT field of the FAB; 
if you do not set the FBSBLK mask, records can span block boundaries. 
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If you are creating a relative or indexed file, the FBSBLK mask has no 
effect on storage of records in the file. However, this mask will be 
preserved and returned on OPEN operations. The FBSBLK mask is ignored 
for files on unit-record devices. 


Note that records are always blocked in a magtape file, regardless of 
the FBSBLK setting. 


Record-Output Handling 


Specify a record-output mask in the l-byte RAT field of the FAB. This 
record-output attribute controls the handling of records that are 
output to a unit-record device: 


e FORTRAN-style record-output specifies FORTRAN-style 
carriage-control handling. 


e Carriage-return record-output specifies that a prefixed 
linefeed and a suffixed carriage-return must be added to each 
record on output to a print device. 


@e Print-format record-output specifies that the file is in print 
format. This format is allowed only for files with VFC 
records for which the fixed header size for each record is 0 
or 2 bytes. (RMS-11 treats a header size of 0 as if you had 
specified 2.) 


When records from the file are written directly to a 
unit-record device, RMS-1ll interprets the first byte of the 
VFC header as a prefix for the record and the second byte of 
the header as a suffix for the record. RMS-11 further 
interprets the prefix/suffix control bytes as follows: 


If the top bit of the control byte is clear, the entire byte 
1s used as a count of the number of carriage return/line feed 
pairs with which to prefix or suffix the record. 


If the top bit of the control byte is set, the low 5 bits of 
the byte are used as the prefix or suffix character. 


If you specify none of these attributes, records are output to 
unit-record devices without special handling. 


If you are creating a file on a device other than a_ unit-record 
device, the record output mask has no effect on storage of records in 
the file. However, this mask will be preserved and returned on OPEN 
operations. 


The symbols for record-output masks are: 


FBSCR Add CRLF to print record (LF-record-CR) 
FBSFTN FORTRAN-Style carriage-control character in record 
FBSPRN VEFC print record handling 


Record Size 


Specify the record size (in bytes) in the l-word MRS field of the FAB 
(unless you have specified undefined record format). For fixed-length 
records, the CREATE operation uses this value as the record size; for 
variable-length records, the CREATE operation uses this value as the 
maximum record size; for VFC records, the CREATE operation uses’ this 
value as the maximum size of the variable portion of each record. 
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If you specify a nonzero value in the MRS field, RMS-11 checks’ the 
Size of each record written to the file against the MRS-field value, 
and returns an error completion if the record size is inappropriate; 
if you specify 0 in the MRS field, RMS-11 does not check record sizes 
against the MRS-field value. 


Maximum Record Number 


If you specify relative file organization (FBSREL value in the ORG 
field), specify the maximum record number in the 2-word MRN field of 
the FAB. If you specify a nonzero value in the MRN field, RMS-11 
checks the record number of each record written to the file against 
the MRN-field value, and returns an error completion if the record 
number is too large; if you specify 0 in the MRN field, RMS-11 does 
not check record numbers against the MRN-field value. 


Private Buffer Pool 


If you want the CREATE operation to use a private buffer pool instead 
of the central buffer pool, specify the address of the (word-aligned) 
private buffer pool in the l-word BPA field of the FAB, and its size 
(in bytes) in the l-word BPS field of the FAB; this size must be a 
multiple of 4. 


If you specify 0 in either the BPA field or the BPS field, the CREATE 
operation uses the central buffer pool. 


The pool that the CREATE operation uses is also used by the DISPLAY 
and EXTEND operations, and by stream and record operations while the 
file is open. 


Logical Channel 


Specify the logical channel for the CREATE operation in the 1l-byte LCH 
field of the FAB. The logical channel number must not be the same as 
the logical channel number for any already-open file, and must not be 
0. 


The logical channel that the CREATE operation uses is also used by the 
DISPLAY and EXTEND operations, and by stream and record or block 
operations while the file is open. 


Retrieval Pointers 


Specify the number of retrieval pointers for the open file in the 
l-byte RTV field of the FAB. If you specify 0, the CREATE operation 
uses the operating system default; if you specify -l, the CREATE 
operation maps as much of the file as possible. 
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Requested Access 


Specify one or more requested-access masks in the l-byte FAC field of 
the FAB. This mask determines the access that the creating program 
nas while the file is open. Regardless of what you specify, the 
CREATE operation includes the mask FBSPUT (for record access) or 
FBSWRT (for block access). The symbols for requested-access masks 
are: 


FBSDEL Request find/get/delete access 
FBSGET Request find/get access 

FBSPUT Request put access 

FBSREA Request block read access 

FBSTRN Request find/get/truncate access 
FBSUPD Request find/get/update access 
FBSWRT Request block write access 


Note that FBSREA and FBSWRT override any record access requested. 


Access Sharing 


Specify the kinds of access that your program is willing to share with 
other programs by setting an access-sharing mask in the l-byte SHR 
field of the FAB. The symbols for access-sharing masks are: 


FBSGET Share find/get access 

FBSNIL No access sharing 

FBSWRI Share find/get/put/update/delete access 
FBSUPI Share any access (user-provided interlock) 


The kinds of access sharing are: 
e Shared read access 


Your program is willing to allow other programs to read _ the 
file, but not to write it. 


e Shared write access 


Your program is willing to allow other programs to both read 
and write the file. Shared write access is not allowed for a 
sequential file unless the file has undefined record format 
and your program opens the file for block access; shared 
write access is also not allowed for a relative or indexed 
file that your program opens for block access. In such cases, 
RMS-11 automatically converts’ the shared write access 
specification to a shared read access specification 
internally. 


e No shared access 


Your program is not willing to allow other programs to either 
read or write the file. RMS-11 does, however, allow other 
programs to read the file unless your program also requests 
some form of write access (which is always the case for 
CREATE). 


e User-provided interlocking 


Your program and other cooperating programs define and enforce 
their own access interlocking; RMS-11 does not check access 
sharing. User-provided interlocking is allowed only for 
sequential disk files; otherwise, the FBSUPI mask is ignored 
(but other masks are honored). 
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Deferred Writing 


If you want deferred buffer writing for the open file, set the FBSDFW 
mask in the l-word FOP field of the FAB; This means that RMS-11l does 
not necessarily write its buffers during a write-type operation 
(DELETE, PUT, or UPDATE), but instead writes buffers only when it 
needs them for other operations (or when your program executes’ the 
FLUSH operation for the stream). 


If you do not set the FBSDFW mask, the DELETE, PUT, and UPDATE 
operations write buffers to the file immediately. 


Note that record operations always use a form of deferred buffer 
writing for sequential files, and that block operations never use 
deferred buffer writing. Therefore you need only decide whether to 
use deferred writing for a record stream to a relative or indexed 
file, 


File Locking 


If you want the file to remain unlocked even if it is closed 
abnormally, set the FBSDLK mask in the l-word FOP field of the FAB; 
if you do not set the FBSDLK mask, the operating system locks the file 
if it is closed abnormally. 


Magtape Block Size 


If you are creating a magtape file, specify the block size (in 
characters) for the file in the l-word BLS field of the FAB. If you 
specify 0, RMS-11 uses the default block size for the device. If you 
specify a nonzero value, it must be in the range 18 through 8192. 


Magtape Positioning 


You can position a magtape file on its magtape. To position the file 
at the beginning of the magtape (overwriting all files on the tape), 
set the FBSRWO mask in the l-word FOP field of the FAB. To position 
the file at the end of the last-closed file (overwriting any following 
files), set the FBSPOS mask in the l-word FOP field of the FAB. Tf 
you set neither of these masks, the CREATE operation positions the 
file at the end of the last file on the magtape (overwriting nothing). 


Rewinding Magtape on Close 


If you want the magtape rewound when the created file is closed, set 
the FBSRWC mask in the l-word FOP field of the FAB. If you do not set 
this mask, the magtape will not be rewound on close unless you set the 
FBSRWC mask for the CLOSE operation. Note, however, that if you set 
the FBSRWC mask for the CREATE operation, the magtape will be rewound 
even if you do not set the FBSRWC mask for the CLOSE operation. 
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Single-Area Unlocated File 
If you want the created file to have only one area, and if you do not 
want to place the area at a specific location on disk, then you supply 
no ALL blocks for the CREATE operation, but rather specify the 
following file attributes in FAB fields (as described in sections 
below): 

e File allocation size 

e Default file extension size 


e File bucket size 


e File contiguity 


Multiarea or Located File 


If you want to place the created file at a specific location on disk, 
or if you want a created indexed file to have more than one area, then 
you supply ALL blocks for the CREATE operation and you specify the 
following area attributes in ALL block fields (as described in 
sections below): 


e Area allocation size 

e Default area extension size 
e Area bucket size 

@e Area contiguity 

e Area alignment 

e Area location 


Specify the area number for each area in the l-byte AID field of the 
ALL block for the area. 


Sequential and relative files are permitted to have only a_=e single 
area: area 0. Thus, for these files, the information in the (single) 
ALL block describes the file as a whole, overriding any corresponding 
information in the FAB. 


Similarly, block-accessed indexed files are treated without regard for 
their internal (logical) structure. In this case, only a single ALL 
block is permitted, and its contents describe the file as a whole, 
overriding any corresponding information in the FAB. 


Symmetric treatment of ALL blocks by the OPEN operation facilitates 
block-access COPY operations, which are independent of file 
organization. 


Allocation Size 


For a Ssingle-area unlocated file, specify the file allocation size (in 
blocks) in the 2-word ALQ field of the FAB. For a multiarea or 
located file, specify the area allocation size (in blocks) in the 
2-word ALQ field of the ALL block for each area. 
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Default Extension Size 


For a single-area unlocated file, specify the default extension size 
(in blocks) for the file in the l-word DEQ field of the FAB. For a 
multiarea or located file, specify the default extension size (in 
blocks) for each area in the l-word DEQ field of the ALL block for the 
area, 


Bucket Size (Relative or Indexed File) 


For a single-area unlocated file, specify the bucket size (in blocks) 
for the file in the l-byte BKS field of the FAB. For a multiarea or 
located file, specify the bucket size (in blocks) for each area in the 
l-byte BKZ field of the ALL block for the area. 


The largest allowed bucket size is 32 blocks; the smallest is 0. If 
you specify a bucket size of 0, the CREATE operation uses 1-block 
buckets for the file or area. 


Area Location 


If you want to place an area at a particular location on disk, specify 
an alignment mask in the l-byte ALN field of the ALL block for the 
area. Logical block alignment places the area at a specified logical 
block; virtual block alignment (not allowed for area 0) places the 
area near a specified virtual block. If you specify no alignment 
mask, the CREATE operation places the area at any convenient location. 
The symbols for alignment masks are: 


XBSLBN Logical block alignment 
XBSVBN Virtual block alignment 


Specify the number of the logical block or virtual block in the 2-word 
Loc field of the ALL block for the area. 


If you do not want the file to be created unless the specified area 
location is available, set the XBSHRD mask in the 1l-byte AOP field of 
the ALL block for the area. If you do not set this mask, the CREATE 
Operation creates the file even if it must place the area at an 
alternate location. Note that hard location at a virtual block 
location is illegal. 


The CREATE operation creates areas by extending the file if either of 
the following is true: 


e You specify placement for areas other than area 0O (in which 
case the CREATE operation ignores the FBSCTG mask). 


e You specify contiguity in one or more ALL blocks, but not in 
the FAB for the file. 


Otherwise the CREATE operation creates the entire file as a single 
Operation, and, if you specified contiguity in the FAB, creates the 
entire file as a single contiguous extent. 
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Contiguity 


If you want a file to be contiguous, set the FBSCTG mask in the 1l-word 
FOP field of the FAB and (for a multiarea file) do not specify disk 
location for any area except (optionally) area 0; if the CREATE 
operation cannot create a contiguous file, it returns an error 
completion; if you do not set this mask, the CREATE operation does 
not attempt to create a contiguous file. 


If you want an area of a multiarea or located file to be contiguous, 
set the  XBSCTG mask in the l-byte AOP field of the ALL block for the 
area. If you set this mask and the CREATE operation cannot create a 
contiguous area, it returns an error completion; if you do not set 
this mask, the CREATE operation does not attempt to create a 
contiguous area. 


Indexes 


If you specify indexed file organization (FBSIDX value in the ORG 
field), you must supply at least one KEY block for the CREATE 
operation, unless you are using block access (in which case, any KEY 
blocks are ignored). Each KEY block you supply defines one index for 
the created file. 


Specify the reference number for each index in the 1l-byte REF field of 
the KEY block for the index. Specify 0 for the primary index, 1 for 
the first alternate index, and so forth. Chain KEY blocks so that the 
reference numbers are in consecutive order, and so that there are no 
intervening XABs of other types (ALL, DAT, PRO, or SUM blocks). 


Key Name 


If you want to define a key name for the index, place the key name 
String in a 32-character buffer. Specify the address of this buffer 
in the l-word KNM field of the KEY block for the index. If you 
specify 0 in the KNM field, the index has no key name. 


Index Key Data Type 


Specify a key data type code in the l-byte DTP field of the KEY block 
for each index. The symbols for key data type codes are: 


XBSBN2 16-bit unSigned integer 
XBSBN4 32-bit unsigned integer 
XBSIN2 15-bit signed integer 
XBSIN4 31-bit signed integer 
XBSPAC Packed decimal number 
XBSSTG String 


Key Segments 
Specify the size and position of each key segment in the 8-byte SIZ 


field of the KEY block and the 8-word POS field of the KEY block for 
the index. (Only a string key can have more than one segment.) 
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The first byte of the SIZ field is for the size (in bytes) of the 
first key segment, the second byte is for the second segment, and so 
forth. If the key is to have fewer than eight segments, specify 0 in 
the remaining bytes of the SIZ field. (The CREATE operation does not 
check segment sizes after the first 0 it encounters in the SIZ field.) 


The first word of the POS field is for the position of the first key 
segment, the second word is for the second segment, and so forth. If 
the key has fewer than eight segments, the CREATE operation ignores 
the remaining words of the POS field. (The first position in a record 
is position 0.) 


Key Changes 


For an alternate index, if you want to allow the key to change during 
update operations, set the XBSCHG mask in the l-byte FLG field of the 
KEY block and the XBSDUP mask in the l-byte FLG field of the KEY block 
for the index; if you do not set these masks, RMS-1ll returns an error 
if a program attempts to change the value of a record key during 
updating. 


Key Duplications 


If you want to allow duplicate keys in an index, set the XBSDUP mask 
in the l~byte FLG field of the KEY block for the index. If you do not 
set this mask, RMS-ll returns an error if a program attempts to insert 
or update a record that would create a duplicate record key. Note 
that the XBSDUP mask must be set if record keys in the index are to be 
changeable during update. 


Null Keys 

If you want to omit null keys from an alternate index, set the XBSNUL 
mask in the l-byte FLG field of the KEY block for the index, and (for 
a string key) specify the null character for the key in the 1-byte NUL 
field of the KEY block (the null value for a nonstring key is 0). 

If you do not set the XBSNUL mask, all keys are included in the index; 
if you set the XBSNUL mask, a nonstring key with a 0 value or a string 
key with an all-null value will not appear in that alternate index. 
Index Areas 


Specify areas for the data records and for the levels of the index: 


e The area for data records in the l-byte DAN field of the KEY 
block 


e The area for the lowest index level in the l-byte LAN field of 
the KEY block 


@e The area for higher index levels in the l-byte IAN field of 
the KEY block 


Note that the bucket sizes of the LAN and IAN areas of a given index 
must be identical. 
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Bucket Fill Numbers 


Bucket fill numbers guide the PUT and UPDATE operations in deciding 
how many records to place in each bucket. A bucket fill number of 0 
is usually appropriate, and specifies that buckets should be filled 
completely. 


A nonzero bucket fill number specifies the number of bytes that should 
be filled in each bucket. If the specified bucket fill number is less 
than half the bucket size, it is rounded up to half the bucket’ size; 
if the specified number is more than the bucket size, it is rounded 
down to the bucket size. 


Specify the fill numbers for data buckets and index buckets: the fill 
Number for data buckets in the l-word DFL field of the KEY block, and 
the fill number for index buckets in the l-word IFL field of the KEY 
block. 


Longest Record Length 


If you specify block access for the created file, and you plan to copy 
an existing file into the new file, you can specify the length of the 
longest record in the new file in the l-word LRL field of the FAB. 


RETURNED VALUES 


Internal File Identifier 


The CREATE operation writes an internal file identifier in the 1-word 
IFI field of the FAB. (The CLOSE operation clears the internal file 
identifier.) 


The CLOSE, CONNECT, DISPLAY, and EXTEND operations read the internal 
file identifier; do not alter the IFI field while the file is open. 


Device Characteristics 


The CREATE operation returns device characteristics as masks in the 
l-byte DEV field of the FAB. The device characteristics are: 


e Printer or terminal (indicated by the set FBSCCL mask in the 
l-byte DEV field of the FAB and the set FBSREC mask in the 
l-byte DEV field of the FAB; for a terminal, the FBSTRM mask 
in the 1l-byte DEV field of the FAB is also set); RMS-11 
treats a printer or terminal as a unit-record device. 


e Disk, DECtape, or DECTAPE II (indicated by the set FBSMDI mask 
in the 1l-byte DEV field of the FAB); RMS-11l treats a disk, 
DECtape, or DECTAPE II as a disk device. 


@e Unit-record device (indicated by the set FBSREC mask in the 
l-byte DEV field of the FAB). 


@ Non-ANSI magtape or cassette tape (indicated by the set FBSSDI 
mask in the 1l-byte DEV field of the FAB and the set FBSREC 
mask in the l-byte DEV field of the FAB); RMS-1l treats a 
non-ANSI magtape or a cassette tape as a unit-record device. 


e ANSI-format magtape (indicated by the set FBSSQD mask in the 
l-byte DEV field of the FAB). 
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Device, Directory, and File Identifiers 


If you supply a NAM block, the CREATE operation writes a device 
identifier in the 2-word DVI field of the NAM block, a directory 
identifier in the 3-word DID field of the NAM block, and a file 
identifier in the 3-word FID field of the NAM block. 


Expanded String 


If you specify a buffer for the expanded string for the file (ESA and 
ESS fields in the NAM block), the CREATE operation writes the file 
specification for the created file in this buffer, and writes the 
length (tin bytes) of the specification string in the l-byte ESL field 
of the NAM block. 


File Specification Characteristics 


The CREATE operation sets masks in the l-word FNB field of the NAM 
block to show which file specification elements were present in the 
file string and default string. These masks and their meanings are: 


NBSNOD Node in file string or default string 

NBSDEV Device in file string or default string 

NBSDIR Directory in file string or default string 

NBSQUO Quoted string in file string or default string 
NBSNAM File name in file string or default string 

NBSTYP File type in file string or default string 

NBSVER File version in file string or default string 
NBSWDI Wildcard directory in file string or default string 
NBSWNA Wildcard file name in file string or default string 
NBSWTY Wildcard file type in file string or default string 
NBSWVE Wildcard file version in file string or default string 


Wildcarding 


The CREATE operation clears the NBSWCH mask in the l-word FNB field of 
the NAM block; this shows that no wildcard context exists after the 
CREATE operation. It also clears the l-byte RSL field of the NAM 
block to show that no resultant string was returned. 


Extension Sizes 


The CREATE operation returns the size (in blocks) of each allocation 
it makes. If you created only area 0 using FAB fields, the CREATE 
Operation writes the size of the allocation in the 2-word ALO field of 
the FAB. If you created areas using ALL blocks, the CREATE operation 
writes the size of each area allocation in the 2-word ALQ field of the 
ALL block for the area. 


Completion Status and Value 
The CREATE operation returns completion status in the l-word STS field 


of the FAB and returns a completion value in the l-word STV field of 
the FAB. Appendix A lists completion status symbols and values. 
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CHECKLISTS 


Table 5-5 lists control block fields that 
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Table 5-5: CREATE Input Fields 


Block Field 


ALL 
ALL 


ALL 
ALL 


ALL 
ALL 
ALL 
ALL 
DAT 
FAB 
FAB 
FAB 
FAB 
FAB 
FAB 
FAB 
FAB 
FAB 


FAB 
FAB 
FAB 


AID 
ALN 


ALQ 
AOP 


BKZ 
DEQ 
LOC 
NXT 
NXT 
ALQ 
BKS 
BLS 
BPA 
BPS 
DEQ 
DNA 
DNS 
FAC 


FNA 
FNS 
FOP 


Description 


Area number 
Initial area alignment request 


XBSLBN 
XBSVBN 


Logical 
Virtual 


block alignment 
block alignment 


Initial area allocation request size 
Area option mask 


XBSCTG 
XBSHRD 


Contiguous area request 
Area hard location request 


Area bucket size (blocks) 

Area default extension size (blocks) 
Initial area location request 

Next XAB address 
Next XAB address 
Initial file allocation request size 
File bucket size (blocks) 

Magtape block size (characters) 
Private buffer pool address 

Private buffer pool size (bytes) 


Permanent file default extension 


Default string address 
Default string size (bytes) 
Requested access 


FBSDEL 
FBSGET 
FBSPUT 
FBSREA 
FBSTRN 
FBSUPD 
FBSWRT 


Request 
Request 
Request 
Request 
Request 
Request 
Request 


mask 


(blocks) 


(blocks) 


size (blocks) 


find/get/delete access 


fFind/get access 
put access 
block read access 


find/get/truncate access 
find/get/update access 


block write access 


File string address 
File string size (bytes) 
File processing option mask 


FBSCTG 
FBSDFW 
FBSDLK 
FBSFID 
FBSMKD 
FBSPOS 
FBSRWC 
FBSRWO 
FBSSUP 
FBSTMD 
FBSTMP 


Contiguous file request 
Defer writing 
No file locking on abnormal close 


Use information in NAM block 


Mark file for deletion 


Position magtape after last-closed file 


Rewind magtape after closing file 

Rewind magtape before creating file 
Supersede existing file 
Temporary file, mark for deletion 
Temporary file 


(Continued on next page) 
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Table 5-5 (Cont.): CREATE Input Fields 


Block Field Description 


FAB FSZ Fixed control area size for VFC records (bytes) 
FAB LCH Logical channel number 

FAB LRL Longest record length 

FAB MRN Maximum record number 

FAB MRS Maximum record size (bytes) 

FAB NAM NAM block address 

FAB ORG File organization code 


FBSIDX Indexed file organization 
FBSREL Relative file organization 
FBSSEQ Sequential file organization 


FAB RAT Record handling mask 
FBSBLK Blocked records 
FBSCR Add CRLF to print record (LF-record-CR) 
FBSFTN FORTRAN-Style carriage-control character in 
record 


FBSPRN VFC print record handling 
FAB RFM Record format code 


FBSFIX Fixed-length record format 
FBSSTM Stream record format 

FBSUDF Undefined record format 
FBSVAR Variable-length record format 
FBSVEC VFC record format 


FAB RTV Retrieval pointer count 
FAB SHR Shared access mask 


FBSGET Share find/get access 
FBSNIL No access sharing 
FBSWRI Share find/get/put/update/delete access 


FBSUPI Share any access (user-provided interlock) 
FAB XAB XAB address 
KEY DAN Data area number 
KEY DFL Data bucket fill factor 
KEY DTP Key data type code 


XBSBN2 16-bit unsigned integer 
XBSBN4 32-bit unsigned integer 
XBSIN2 15-bit signed integer 
XBSIN4 31-bit signed integer 
XBS PAC Packed decimal number 
XBSSTG String 


KEY FLG Index option mask 
XBSDUP Duplicate record keys allowed 


XBSCHG Record key changes allowed on update 
XBSNUL Null record keys not indexed 


KEY IAN Higher level index area number 
KEY IFL Index bucket fill factor 
KEY KNM Key name buffer address 
KEY LAN Lowest index level area number 


(Continued on next page) 
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Block Field 


Table 5-5 (Cont.): CREATE Input Fields 


Description 


KEY 
KEY 
KEY 
KEY 
KEY 
NAM 
NAM 
NAM 
NAM 
PRO 
PRO 
SUM 


NUL 
NXT 
POS 
REF 
SIZ 
ESA 
DID 
DVI 
ESS 
NXT 
PRO 
NXT 


Null key character 

Next XAB address 

Key segment positions 

Index reference number 

Key segment sizes (bytes) 
Expanded string buffer address 
Directory identifier 

Device identifier 

Expanded string buffer size (bytes) 
Next XAB address 

File protection code 

Next XAB address 


Table 5-6: CREATE Output Fields 


Block Field 


ALL 
FAB 
FAB 


FAB 
FAB 
FAB 
NAM 
NAM 
NAM 
NAM 
NAM 


NAM 


ALQ 
ALQ 
DEV 


IFI 
STS 
STV 
DID 
DVI 
ESL 
FID 
FNB 


RSL 


Description 


Initial area allocation size (blocks) 
Initial file allocation size (blocks) 
Device characteristic mask 


FBSCCL Carriage-control device 
FBSMDI Multidirectory device 
FBSREC Record-oriented device 
FBSSDI Single-directory device 
FBSSQD Sequential device 
FBSTRM Terminal device 


Internal file identifier 
Completion status code 
Completion status value 
Directory identifier 

Device identifier 

Expanded string length (bytes) 
File identifier 

File specification mask 


NBSNOD Node in file string or default string 

NBSDEV Device in file string or default string 

NBSDIR Directory in file string or default string 

NBSQUO Quoted string in file string or default 
string 

NBSNAM File name in file string or default string 

NBSTYP File type in file string or default string 

NBSVER File version in file string or default 
string 

NBSWDI Wildcard directory in file string or 
default string 

NBSWNA Wildcard file name in file string or 
default string 

NBSWTY Wildcard file type in file string or 
default string 

NBSWVE Wildcard file version in file string or 
default string 

NBSWCH Wildcard context established (cleared) 


Resultant string length (bytes) 


(cleared) 
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5.4 S$DELETE MACRO 


The SDELETE macro calls the DELETE operation routine to remove a 
record from a relative or indexed file. The target of the DELETE 
operation is the current record. The current record must be locked; 
it was automatically locked when the current-record context was set, 
but you must not have unlocked it with a FREE operation. 


If the stream hasS no current-record context, or if the current record 
is not locked, the DELETE operation returns an error completion. 


FORMAT 
The format for the SDELETE is: 
SDELETE rabaddr[,f{erraddr] [,sucaddr] } 


where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the DELETE operation. 


OPTIONS 


Internal Stream Identifier 


The DELETE operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 


Fast Deletion (Indexed File) 


If the file is an indexed file, and if its alternate indexes allow 
duplicate keys, then you can speed up the DELETE operation by using 
the fast-deletion procedure. However, this procedure is faster 
because it deletes only those alternate index pointers that it must; 
future retrieval operations may be slowed by the presence of undeleted 
alternate index pointers. 


To use the fast-deletion procedure with the DELETE operation, set the 
RBSFDL mask in the 1l-word ROP field of the RAB. If you do not set 
this mask, the DELETE operation does not use the fast-deletion 
procedure. 


Asynchronous Operation 


If you want to execute the DELETE operation asynchronously, set the 
RBSASY mask in the 1l-word ROP field of the RAB; if you do not set 
this mask, the DELETE operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 
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STREAM CONTEXT 


The current-record context after a DELETE operation is undefined; the 
next-record context is unchanged. 


RETURNED VALUES 


Completion Status and Value 
The DELETE operation returns completion status in the l-word STS field 


of the RAB and returns a completion value in the l-word STV field of 
the RAB. Appendix A lists completion status symbols and values. 


CHECKLISTS 
Table 5-7 lists control block fields that are input to the DELETE 
operation. Table 5-8 lists control block fields that are output by 
the DELETE operation. 
Table 5-7: DELETE Input Fields 
Block Field Description 
RAB ISI Internal stream identifier 


RAB ROP Record processing option mask 


RBSASY Asynchronous operation 
RBSFDL Fast deletion 


Table 5-8: DELETE Output Fields 
Block Field Description 


RAB STS Completion status code 
RAB STV Completion status value 
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5.5 $DISCONNECT MACRO 
The SDISCONNECT macro calls the DISCONNECT operation routine to 
terminate a stream and disconnect it, releasing the internal resources 
it was using. The stream context is lost; you cannot reestablish the 
same stream context by reconnecting the stream with the CONNECT 
operation. 
FORMAT 
The format for the SDISCONNECT is: 
SDISCONNECT rabaddr([,[erraddr] [,sucaddr] ] 

where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the DISCONNECT operation. 
OPTIONS 


Internal Stream Identifier 

The DISCONNECT operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 

Asynchronous Operation 

If you want to execute the DISCONNECT operation asynchronously, set 
the RBSASY mask in the l-word ROP field of the RAB; if you do not set 
this mask, the DISCONNECT operation executes synchronously. (Your 
program must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 

STREAM CONTEXT 

The DISCONNECT operation terminates the stream; therefore there is no 
stream context after the DISCONNECT operation. 


RETURNED VALUES 


Internal Stream Identifier (Cleared) 


The DISCONNECT operation clears the internal stream identifier from 
the l-word ISI field of the RAB. 


Completion Status and Value 


The DISCONNECT operation returns completion status in the l-word STS 
field of the RAB and returns a completion value in the l-word STV 
field of the RAB. Appendix A lists completion status symbols. and 
values. 
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CHECKLISTS 


Table 5-9 lists control block fields that are input to the DISCONNECT 
operation. Table 5-10 lists control block fields that are output by 
the DISCONNECT operation. 


Table 5-9: DISCONNECT Input Fields 


Block Field Description 


RAB LSI Internal stream identifier 
RAB ROP Record processing option mask 


RBSASY Asynchronous operation 


Table 5-10: DISCONNECT Output Fields 


Block Field Description 


RAB ISI Internal stream identifier 
RAB STS Completion status code 
RAB STV Completion status value 
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5.6 SDISPLAY MACRO 


The SDISPLAY macro calls the DISPLAY operation routine to write values 
into control block fields. The DISPLAY operation does not alter the 
file in any way. 


When you use the OPEN operation to open a file, you might not know how 
many areas or how many indexes the file has. If, however, you supply 
a SUM block for the OPEN operation, the OPEN operation writes the 
number of areas and number of keys (indexes) in its fields. You can 
then supply ALL blocks and KEY blocks so that the DISPLAY operation 
can fill their fields with values describing the file areas and 
indexes. 


FORMAT 
The format for the SDISPLAY is: 
SDISPLAY fabaddr[,[erraddr] [,sucaddr] ] 


where fabaddr is the address of the FAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 
You must supply a FAB for the DISPLAY operation. 


If the file is an indexed file, for each ALL block that you supply, 
the DISPLAY operation fills its fields with values describing the 
corresponding area (if any) of the file. You need not supply an ALL 
block for every area of the file. Note that if the file was opened 
for block access, no information is returned in ALL blocks. 


For each KEY block that you supply, the DISPLAY operation fills its 
fields with values describing the corresponding index (if any) for the 
file. You need not supply a KEY block for every index of the file. 
Note that if the file was opened for block access, no information is 
returned in KEY blocks. 


If you supply a PRO block for a disk file, the DISPLAY operation fills 
its fields with values showing the owner and protection for the file. 


If you supply a DAT block for a disk file, the DISPLAY operation fills 
its fields with values showing the creation date, expiration date, 
revision date, and revision number for the file. 


If you supply a SUM block for a relative or indexed file, the DISPLAY 
operation fills its fields with values showing the number of areas and 
indexes for the file, and with its prologue version number. (If you 
are opening the file for block access, the DISPLAY operation returns 
the number of areas and number of keys as 0, and does not return the 
prologue version number.) 


To supply XABs (ALL, DAT, KEY, PRO, and SUM blocks) for the DISPLAY 
operation, specify the address of the first XAB in the l-word XAB 
field of the FAB; specify the address of the next XAB (if any) in the 
l-word NXT field of each XAB; specify 0 in the NXT field of the last 
XAB. 
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All KEY blocks must be together in the chain of XABs, and must be in 
ascending order (by the index reference number in the l-byte REF field 
of the KEY block); the index reference numbers need not be 
consecutive. 


All ALL blocks must be together in the chain of XABs, and must be in 
ascending order (by the area identifier in the l-byte AID field of the 
ALL block); the area identifiers need not be consecutive. 


Multiple DAT, PRO, or SUM XABs are illegal. 


OPTIONS 


Internal File Identifier 


The DISPLAY operation reads the internal file identifier from _ the 
l-word IFI field of the FAB. This is the value that was written when 
the file was opened by the CREATE or OPEN operation. 


Key Name Buffer 


If you want the key name string for an index returned to ae buffer, 
supply a KEY block for the index; specify the address of a 32-byte 
buffer in the l-word KNM field of the KEY block. If you do not supply 
a KEY block for an index, or if you specify 0 in its KNM field, the 
DISPLAY operation does not return the key name string. 


STREAM CONTEXT 


The DISPLAY operation does not affect stream context. 


RETURNED VALUES 


Area Descriptions 


For each ALL block that you supply, the DISPLAY operation writes a 
description in its fields of the corresponding area of the file. Area 
0 is described in the ALL block containing 0 in its AID field; area 1 
is described in the ALL block containing 1 in its AID field; and so 
forth. 


The DISPLAY operation writes three sizes for a file area: the size 
(in blocks) of the unused portion of the area in the 2-word ALQ field 
of the ALL block, the default area extension size (in blocks) in the 
l-word DEQ field of the ALL block, and the area bucket size (in 
blocks) in the l-byte BKZ field of the ALL block. 


The DISPLAY operation clears the l-byte AOP field of the ALL block and 
the l-byte ALN field of the ALL block. 


Key Descriptions 


For each KEY block that you supply, the DISPLAY operation writes a 
description in its fields of the corresponding index of the file. The 
primary index is described in the KEY block containing 0 in its REF 
field; the first alternate index is described in the KEY block 
containing 1 in its REF field; and so forth. 
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The DISPLAY operation writes the key data type code in the l-byte DTP 
field of the KEY block. The symbols for key data type codes are: 


XBSBN2 16-bit unsigned integer 
XBSBN4 32-bit unsigned integer 
XBSIN2 15-bit signed integer 
XBSIN4 31-bit signed integer 
XBSPAC Packed decimal number 
XBSSTG String 


The DISPLAY operation writes key segment information for the index: 
the number of key segments in the l-byte NSG field of the KEY block, 
and the total key size (sum of segments, in bytes) in the 1l-byte TKS 
field of the KEY block. 


The DISPLAY operation writes the sizes of key segments in the 8-byte 
SIZ field of the KEY block. The size (in bytes) of the first key 
segment is in the first byte of the SIZ field, the size of the second 
segment is in the second byte of the SIZ field, and so forth. If the 
key has fewer than eight segments, the first byte containing 0 
indicates the number of key segments. 


The DISPLAY operation writes the positions of key segments in the 
8-word POS field of the KEY block. The position (leftmost position is 
0) of the first key segment is in the first word of the POS field, the 
position of the second segment is in the second word of the POS field, 
and so forth. If the key has fewer than eight segments, the remaining 
words of the POS field contain unpredictable values. 


The DISPLAY operation writes a key-characteristics mask in the 1-byte 
FLG field of the KEY block. The symbols for key-characteristics masks 
are: 


XBSCHG Record key changes allowed on update 
XBSDUP Duplicate record keys allowed 

XBSINI No entries yet made in index 

XBSNUL Null record keys not indexed 


The DISPLAY operation writes the null-key character in the l-byte NUL 
field of the KEY block. This character is meaningful only if the 
XBSNUL mask in the l-byte FLG field of the KEY block is set and_ the 
DISPLAY operation returns the XBSSTG code in the l-byte DTP field of 
the KEY block (indicating a string key). 


The DISPLAY operation writes area numbers for the index: the area for 
the data level in the l-byte DAN field of the KEY block, the area for 
the lowest index level in the l-byte LAN field of the KEY block, and 
the area for higher index levels in the l-byte IAN field of the KEY 
block. 


The DISPLAY operation writes bucket fill numbers for the index areas: 
the fill number for the data area in the l-word DFL field of the KEY 
block, and the fill number for the index areas in the l-word IFL field 
of the KEY block. 


The DISPLAY operation writes bucket sizes for index areas: the data 
area bucket size (in blocks) in the l-byte DBS field of the KEY block, 
and the index area bucket size (in blocks) in the l-byte IBS field of 
the KEY block. 


The DISPLAY operation writes virtual block numbers for the index 
areas: the virtual block number for the first data bucket in the 
2-word DVB field of the KEY block, and the virtual block number of the 
root index bucket in the 2-word RVB field of the KEY block. 
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The DISPLAY operation writes the number of levels in the index (not 
including the data level) in the l-byte LVL field of the KEY block. 


The DISPLAY operation writes the minimum size (in bytes) of a record 
that contains the key for the index in the l-word MRL field of the KEY 
block. 


File Owner and Protection (Disk File) 


If the file is a disk file, and if you supply a PRO block, the DISPLAY 
operation writes the project (or group) portion of the file owner code 
in the l-word PRJ field of the PRO block, the programmer (or member) 
portion of the file owner code in the l-word PRG field of the PRO 
block, and the file protection code in the l-word PRO field of the PRO 
block. 


File Dates 


If you supply a DAT block for a disk file, the DISPLAY operation 
writes four values in its fields: the creation date in the 4-word CDT 
field of the DAT block, the expiration date in the 4-word EDT field of 
the DAT block, the revision date in the 4-word RDT field of the DAT 
block, and the revision number (number of times the file has been 
write-accessed and then closed) in the l-word RVN field of the DAT 
block. 


File Summary Information 


If you supply a SUM block, the DISPLAY operation writes three values 
in its fields: the number of file areas in the l-byte NOA field of 
the SUM block, the number of file indexes in the l-byte NOK field of 
the SUM block, and the prologue version number (for a relative or 
indexed file) in the l-word PVN field of the SUM block. 


Completion Status and Value 


The DISPLAY operation returns completion status in the Jl-word STS 
field of the FAB and returns a completion value in the l-word STV 
field of the FAB. Appendix A lists completion status symbols’ and 
values. 


CHECKLISTS 


Table 5-11 lists control block fields that are input to the DISPLAY 
operation. Table 5-12 lists control block fields that are output by 
the DISPLAY operation. 


Block Field 


ALL 
ALL 
DAT 
FAB 
FAB 
KEY 
KEY 
KEY 
PRO 
SUM 


Block Field 


ALL 
ALL 
ALL 


ALL 
ALL 
DAT 
DAT 
DAT 
DAT 
FAB 
FAB 
KEY 
KEY 
KEY 
KEY 


KEY 
KEY 


AID 
NXT 
NXT 
IFI 
XAB 
NXT 
KNM 
REF 
NXT 
NXT 


ALN 
ALQ 
AOP 


BKZ 
DEQ 
CDT 
EDT 
RDT 
RVN 
STS 
STV 
DAN 
DBS 
DFL 
DTP 


DVB 
FLG 
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Table 5-11: DISPLAY Input Fields 


Description 


Area number 

Next XAB address 

Next XAB address 
Internal file identifier 
XAB address 

Next XAB address 

Key name buffer address 
Index reference number 
Next XAB address 

Next XAB address 


Table 5-12: DISPLAY Output Fields 


Description 


Area alignment mask (cleared) 
Unused area allocation size (blocks) 
Area option mask 


XBSCTG 
XBSHRD 


Contiguous area (cleared) 
Hard area location (cleared) 


Area bucket size (blocks) 

Area default extension size (blocks) 
File creation date 

File expiration date 

File revision date 

File revision number 
Completion status code 
Completion status value 

Data area number 

Data area bucket size (blocks) 
Data bucket fill factor 

Key data type code 


XBSBN2 
XBSBN4 
XBSIN2 
XBSIN4 
XBSPAC 
XBSSTG 


16-bit unsigned integer 
32-bit unsigned integer 
15-bit signed integer 
31-bit signed integer 
Packed decimal number 
String 


First data bucket virtual block number 
Index option mask 


XBSCHG 
XBSDUP 
XBSINI 
XBSNUL 


Record key changes allowed on update 
Duplicate record keys allowed 

No entries yet made in index 

Null record keys not indexed 


(Continued on next page) 
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Block Field 


KEY 
KEY 
KEY 
KEY 
KEY 
KEY 
KEY 
KEY 
KEY 
KEY 
KEY 
KEY 
PRO 
PRO 
PRO 
SUM 
SUM 
SUM 


IAN 
IBS 
IFL 
LAN 
LVL 
MRL 
NSG 
NUL 
POS 
RVB 
SIZ 
TKS 
PRG 
PRJ 
PRO 
NOA 
NOK 
PVN 


Table 5-12 (Cont.): DISPLAY Output Fields 


Description 


Higher level index area number 

Index area bucket size (blocks) 

Index bucket fill factor 

Lowest index level area number 

Number of index levels (not including data level) 
Minimum length of record containing key (bytes) 
Key segment count 

Null key character 

Key segment positions 

Root index bucket virtual block number 

Key segment sizes (bytes) 

Total key size (sum of key segment sizes) (bytes) 
Programmer or member portion of file owner code 
Project or group portion of file owner code 

File protection code 

Number of areas 

Number of indexes 

Prologue version number 
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5.7 SENTER MACRO 
The SENTER macro calls the ENTER operation routine to insert a file 
name into a directory file. 
FORMAT 
The format for the SENTER is: 
SENTER fabaddr[,[erraddr] [,sucaddr} ] 
where fabaddr is the address of the FAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 
CONTROL BLOCKS 
You must supply a FAB for the ENTER operation. 
You must supply a NAM block for the ENTER operation. 


To supply a NAM block for the ENTER operation, specify the address of 
the NAM block in the l-word NAM field of the FAB. 


To supply XABs (ALL, DAT, KEY, PRO, and SUM _ blocks) for the ENTER 
operation, specify the address of the first XAB in the l-word XAB 
field of the FAB; specify the address of the next XAB (if any) in the 
l-word NXT field of each XAB; specify 0 in the NXT field of the last 
XAB. 


All KEY blocks must be together in the chain of XABs, and must be in 
ascending order (by the index reference number in the l-byte REF field 
of the KEY block); the index reference numbers need not be 
consecutive. 

All ALL blocks must be together in the chain of XABs, and must be in 
ascending order (by the area identifier in the l-byte AID field of the 
ALL block); the area identifiers need not be consecutive. 


Multiple DAT, PRO, or SUM XABs are illegal. 


OPTIONS 


File Specification 
The ENTER operation constructs the full file specification from the 
file string, the default string (which contributes only elements not 
present in the file string), and RMS-11 defaults (which contribute 
elements not present in either the file string or the default string). 
RMS-11 defaults are: 
@e Device -- The device to which the specified logical channel is 
assigned, or SY: if the specified logical channel is not 
assigned to any device. 


@e Directory -- The current directory for the task. 


e Name, type, version -- Defaulted to null. 
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The file string and the default string must not contain wildcards. 


Specify the address of the file string in the l-word FNA field of the 
FAB. Specify the size (in bytes) of the file string in the l-byte FNS 
field of the FAB; if you specify 0 in the FNS field, the ENTER 
operation uses no file string. 


Specify the address of the default string in the l-word DNA field of 
the FAB. Specify the size (in bytes) of the default string in the 
l-byte DNS field of the FAB; if you specify 0 in the DNS field, the 
ENTER operation uses no default string. 


If you set the FBSFID mask in the l-word FOP field of the FAB- and 
supply a NAM block, the ENTER operation reads the device identifier 
from the 2-word DVI field of the NAM block; if this value is nonzero, 
the specified device overrides the device in the merged string. 


In the same circumstance, the ENTER operation reads the directory 
identifier from the 3-word DID field of the NAM block; if this value 
1s nonzero, the specified directory overrides the directory in _ the 
merged string. 


You must provide a NAM block for the ENTER operation, and must provide 
a valid file identifier in the 3-word FID field of the NAM block. 
This identifier specifies the file for which the entry (name, type, 
and version) will be created in the target directory. 


Expanded String Buffer 


If you want the ENTER operation to return the expanded string for the 
created file, provide a buffer for the string. Specify the address of 
the expanded string buffer in the l-word ESA field of the NAM block. 
Specify the size (in bytes) of the expanded string buffer in the 
l-byte ESS field of the NAM block; if you specify 0 in the ESS field, 
the ENTER operation does not return the expanded string. 


Private Buffer Pool 


If you want the ENTER operation to use a private buffer pool instead 
of the central buffer pool, specify the address of the (word-aligned) 
private buffer pool in the l-word BPA field of the FAB, and its’ size 
(in bytes) in the l-word BPS field of the FAB; this size must be a 
multiple of 4. 


If you specify 0 in either the BPA field or the BPS field, the ENTER 
Operation uses the central buffer pool. 


Logical Channel 


Specify the logical channel for the ENTER operation in the l-byte LCH 
field of the FAB. The logical channel number must not be the same as 
the logical channel number for any already-open file, and must not be 
0. 
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RETURNED VALUES 


Expanded String 


If you specify a buffer for the expanded string for the file (ESA and 
ESS fields in the NAM block), the ENTER operation writes the file 
specification for the target file in this buffer, and writes’ the 
length (in bytes) of the specification string in the l-byte ESL field 
of the NAM block. 


Device Characteristics 


The ENTER operation returns device characteristics as masks in the 
l-byte DEV field of the FAB. The device characteristics are: 


e Printer or terminal (indicated by the set FBSCCL mask in the 
l-byte DEV field of the FAB and the set FBSREC mask in the 
l-byte DEV field of the FAB; for a terminal, the FBSTRM mask 
in the l-byte DEV field of the FAB is also set); RMS-11 
treats a printer or terminal as a unit-record device. 


e Disk, DECtape, or DECTAPE II (indicated by the set FBSMDI mask 
in the 1l-byte DEV field of the FAB); RMS-1ll treats a disk, 
DECtape, or DECTAPE II as a disk device. 


e Unit-record device (indicated by the set FBSREC mask in the 
l-byte DEV field of the FAB). 


@ Non-ANSI magtape or cassette tape (indicated by the set FBSSDI 
mask in the 1l-byte DEV field of the FAB and the set FBSREC 
mask in the l-byte DEV field of the FAB); RMS-ll treats a 
non-ANSI magtape or a cassette tape as a unit-record device. 


e ANSI-format magtape (indicated by the set FBSSQD mask in the 
l-byte DEV field of the FAB). 


Device and Directory Identifiers 


The ENTER operation returns the device identifier for the target file 
in the 2-word DVI field of the NAM block and the directory identifier 
in the 3-word DID field of the NAM block. 


File Specification Characteristics 


The ENTER operation sets masks in the l-word FNB field of the NAM 
block to show which file specification elements were present in the 
file string and default string. These masks and their meanings are: 


NBSNOD Node in file string or default string 

NBSDEV Device in file string or default string 

NBSDIR Directory in file string or default string 

NBSQUO Quoted string in file string or default string 
NBSNAM File name in file string or default string 

NBSTYP File type in file string or default string 

NBSVER File version in file string or default string 
NBSWDI Wildcard directory in file string or default string 
NBSWNA Wildcard file name in file string or default string 
NBSWTY Wildcard file type in file string or default string 
NBSWVE Wildcard file version in file string or default string 
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Wildcarding 

The ENTER operation clears the NBSWCH mask in the l-word FNB field of 
the NAM block and the l-byte RSL field of the NAM block; this shows 
that no wildcard context exists and that no resultant string was 
returned. 

Completion Status and Value 

The ENTER operation returns completion status in the l-word STS field 
of the FAB and returns a completion value in the l-word STV field of 
the FAB. Appendix A lists completion status symbols and values. 
CHECKLISTS 

Table 5-13 lists control block fields that are input to the ENTER 
operation. Table 5-14 lists control block fields that are output by 
the ENTER operation. 


Table 5-13: ENTER Input Fields 


Block Field Description 


ALL NXT Next XAB address 

DAT NXT Next XAB address 

FAB BPA Private buffer pool address 

FAB BPS Private buffer pool size (bytes) 
FAB DNA Default string address 

FAB DNS Default string size (bytes) 

FAB FNA File string address 

FAB FNS File string size (bytes) 

FAB FOP File processing option mask 


FBSFID Use information in NAM block 


FAB LCH Logical channel number 

FAB NAM NAM block address 

KEY NXT Next XAB address 

NAM DID Directory identifier 

NAM DVI Device identifier 

NAM ESA Expanded string buffer address 

NAM ESS Expanded string buffer size (bytes) 
NAM FID File identifier 

PRO NXT Next XAB address 

SUM NXT Next XAB address 
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Table 5-14: ENTER Output Fields 


Block Field Description 


FAB DEV Device characteristic mask 


FBSCCL Carriage-control device 
FBSMDI Multidirectory device 
FBSREC Record-oriented device 
FBSSDI Single-directory device 
FBSSQD Sequential device 
FBSTRM Terminal device 


FAB STS Completion status code 

FAB STV Completion status value 

NAM DID Directory identifier 

NAM DVI Device identifier 

NAM ESL Expanded string length (bytes) 
NAM FNB File specification mask 


NBSNOD Node in file string or default string 

NBSDEV Device in file string or default string 

NBSDIR Directory in file string or default string 

NBSQUO Quoted string in file string or default 
string 

NBSNAM File name in file string or default string 

NBSTYP File type in file string or default string 

NBSVER File version in file string or default 
string 

NBSWDI Wildcard directory in file string or 
default string 

NBSWNA Wildcard file name in file string Or 
default string 

NBSWTY Wildcard file type in file string or 
default string 

NBSWVE Wildcard file version in file string or 
default string 

NBSWCH Wildcard context established (cleared) 


NAM RSL Resultant string length (bytes) (cleared) 
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5.8 SERASE MACRO 


The SERASE macro calls the ERASE operation routine to erase a file and 
delete its directory entry. Note that erasing a file marks the file 
for deletion, but does not necessarily erase the file immediately; 
the file is erased when it has no accessing programs. The allocation 
for the file is released for use in other files. 


FORMAT 
The format for the SERASE is: 
SERASE fabaddr[,[erraddr] [,sucaddr] ] 


where fabaddr is the address of the FAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 
You must supply a FAB for the ERASE operation. 


If you supply a NAM block and specify wildcarding, the ERASE operation 
reads the address and length of the expanded string from NAM block 
fields; if you supply a NAM block and specify erase by NAM block, the 
ERASE operation reads NAM block fields to obtain identifiers for the 
target file. 


To supply a NAM block for the ERASE operation, specify the address of 
the NAM block in the l-word NAM field of the FAB. 


To supply XABs (ALL, DAT, KEY, PRO, and SUM blocks) for the ERASE 
Operation, specify the address of the first XAB in the l-word XAB 
field of the FAB; specify the address of the next XAB (if any) in the 
l-word NXT field of each XAB; specify 0 in the NXT field of the last 
XAB. 


All KEY blocks must be together in the chain of XABs, and must be in 
ascending order (by the index reference number in the 1l-byte REF field 
of the KEY block); the index reference numbers need not be 
consecutive. 


All ALL blocks must be together in the chain of XABS, and must be in 
ascending order (by the area identifier in the l-byte AID field of the 
ALL block); the area identifiers need not be consecutive. 


Multiple DAT, PRO, or SUM XABs are illegal. 


OPTIONS 


File Specification (Nonwildcard ERASE Operation) 


The ERASE operation constructs the full file specification from _ the 
file string, the default string (which contributes only elements not 
present in the file string), and RMS-1ll defaults (which contribute 
elements not present in either the file string or the default string). 
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RMS-11 defaults are: 


e Device -- The device to which the specified logical channel is 
assigned, or SY: if the specified logical channel is not 
assigned to any device. 


@ Directory -- The current directory for the task. 
e Name, type, version -- Defaulted to null. 
The file string and the default string must not contain wildcards. 


Specify the address of the file string in the l-word FNA field of the 
FAB. Specify the size (in bytes) of the file string in the l-byte FNS 
field of the FAB; if you specify 0 in the FNS field, the ERASE 
operation uses no file string. 


Specify the address of the default string in the l-word DNA field of 
the FAB. Specify the size (in bytes) of the default string in the 
l-byte DNS field of the FAB; if you specify 0 in the DNS field, the 
ERASE operation uses no default string. 


If you set the FBSFID mask in the l-word FOP field of the FAB and 
supply a NAM block, the ERASE operation reads the device identifier 
from the 2-word DVI field of the NAM block; if this value is nonzero, 
the specified device overrides the device in the merged string. 


In the same circumstance, the ERASE operation reads the directory 
identifier from the 3-word DID field of the NAM block; if this value 
is nonzero, the specified directory overrides the directory in the 
merged string. 


In the same circumstance, the ERASE operation reads the file 
identifier from the 3-word FID field of the NAM block; if this value 
is nonzero, the specified file overrides any directory, name, type, 
and version elements previously obtained, and the file is erased 
without removing any directory entry that may exist for it. 


Erase by Wildcard Specification 


You can use the ERASE operation in a wildcarding program loop. (The 
NBSWCH mask in the l-word FNB field of the NAM block will already have 
been set by an earlier PARSE operation.) 


If you set the FBSFID mask in the l-word FOP field of the FAB, the 
file found by a previous SEARCH operation and its directory entry are 
deleted, but all fields relevant to wildcard context are preserved 
(for possible subsequent SEARCH operations). 


If you clear the FBSFID mask in the l-word FOP field of the FAB, the 
ERASE operation first performs an implicit SEARCH operation. (The 
input and output fields for the SEARCH operation are not described 
here and are not included in the checklists at the end of this 
section.) 


If the SEARCH operation finds a file that matches the wildcard file 
specification, the ERASE operation erases its contents and deletes its 
directory entry; if not, the ERASE operation does not erase the file 
contents or delete its directory entry, but instead passes control 
block data from the SEARCH operation (in particular, the ERSNMF 
completion status code and the cleared NBSWCH mask in the l-word FNB 
field of the NAM block). 
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Expanded String Buffer 


If you erase a file by its file specification, and if you want the 
ERASE operation to return the expanded string for the erased file, 
provide a buffer for the string. Specify the address of the expanded 
string buffer in the l-word ESA field of the NAM block. Specify the 
size (in bytes) of the expanded string buffer in the l-byte ESS field 
of the NAM block; if you specify 0 in the ESS field, the ERASE 
operation does not return the expanded string. 


Private Buffer Pool 


If you want the ERASE operation to use a private buffer pool instead 
of the central buffer pool, specify the address of the (word-aligned) 
private buffer pool in the l-word BPA field of the FAB, and its size 
(in bytes) in the l-word BPS field of the FAB; this size must be a 
multiple of 4. 


If you specify 0 in either the BPA field or the BPS field, the ERASE 
operation uses the central buffer pool. 


Logical Channel 


Specify the logical channel for the ERASE operation in the l-byte LCH 
field of the FAB. The logical channel number must not be the same as 
the logical channel number for any already-open file, and must not be 
0. 


RETURNED VALUES 


Expanded String 


If you specify a buffer for the expanded string for the file (ESA and 
ESS fields in the NAM block), the ERASE operation writes the expanded 
string for the erased file in the buffer, and writes the length (in 
bytes) of the string in the l-byte ESL field of the NAM block. 


Device, Directory, and File Identifiers 


If you supply a NAM block, the ERASE operation writes a device 
identifier in the 2-word DVI field of the NAM block, a directory 
identifier in the 3-word DID field of the NAM block (unless directory 
processing was bypassed due to use of the file identifier on input), 
and a file identifier in the 3-word FID field of the NAM block. 


Device Characteristics 


The ERASE operation returns device characteristics as masks in the 
l-byte DEV field of the FAB. The device characteristics are: 


e Printer or terminal (indicated by the set FBSCCL mask in the 
l-byte DEV field of the FAB and the set FBSREC mask in the 
l-byte DEV field of the FAB; for a terminal, the FBSTRM mask 
in the 1-byte DEV field of the FAB is also set); RMS-11 
treats a printer or terminal as a unit-record device. 


e Disk, DECtape, or DECTAPE II (indicated by the set FBSMDI mask 


in the 1l-byte DEV field of the FAB); RMS-1l1 treats a disk, 
DECtape, or DECTAPE II as a disk device. 


5-42 


OPERATION MACRO DESCRIPTIONS 
SERASE MACRO 


e Unit-record device (indicated by the set FBSREC mask in the 
l-byte DEV field of the FAB). 


e Non-ANSI magtape or cassette tape (indicated by the set FBSSDI 
mask in the l-byte DEV field of the FAB and the set FBSREC 
mask in the l-byte DEV field of the FAB); RMS-ll treats a 
non-ANSI magtape or a cassette tape as a unit-record device. 


e ANSI-format magtape (indicated by the set FBSSQD mask in the 
l-byte DEV field of the FAB). 


Wildcard Context 


A nonwildcard ERASE operation clears the NBSWCH mask in the l-word FNB 
field of the NAM block and the l-byte RSL field of the NAM block; 
this shows that no wildcarding is in progress and that no resultant 
string was returned. 


File Specification Characteristics 


The ERASE operation sets masks in the l-word FNB field of the NAM 
block to show which file specification elements were present in the 
file string and default string. These masks and their meanings are: 


NBSNOD Node in file string or default string 

NBSDEV Device in file string or default string 

NBSDIR Directory in file string or default string 

NBSQUO Quoted string in file string or default string 
NBSNAM File name in file string or default string 

NBSTYP File type in file string or default string 

NBSVER File version in file string or default string 
NBSWDI Wildcard directory in file string or default string 
NBSWNA Wildcard file name in file string or default string 
NBSWTY Wildcard file type in file string or default string 
NBSWVE Wildcard file version in file string or default string 


Completion Status and Value 

The ERASE operation returns completion status in the l-word STS field 
of the FAB and returns a completion value in the l-word STV field of 
the FAB. Appendix A lists completion status symbols and values. 
CHECKLISTS 

Table 5-15 lists control block fields that are input to the ERASE 


operation. Table 5-16 lists control block fields that are output by 
the ERASE operation, 
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Table 5-15: ERASE Input Fields 


Block Field Description 


ALL NXT Next XAB address 

DAT NXT Next XAB address 

FAB BPA Private buffer pool address 

FAB BPS Private buffer pool size (bytes) 
FAB DNA Default string address 

FAB DNS Default string size (bytes) 

FAB FNA File string address 

FAB FNS File string size (bytes) 

FAB FOP File processing option mask 


FBSFID Use information in NAM block 


FAB LCH Logical channel number 

FAB NAM NAM block address 

KEY NXT Next XAB address 

NAM DID Directory identifier 

NAM DVI Device identifier 

NAM ESA Expanded string buffer address 
NAM ESS Expanded string buffer size (bytes) 
NAM FID File identifier 

NAM FNB File specification mask 

PRO NXT Next XAB address 

SUM NXT Next XAB address 


NBSWCH Wildcard context established 


Table 5-16: ERASE Output Fields 


Block Field Description 


FAB DEV Device characteristic mask 


FBSCCL Carriage-control device 
FBSMDI Multidirectory device 
FBSREC Record-oriented device 
FBSSDI Single-directory device 
FBSSQD Sequential device 
FBSTRM Terminal device 


FAB STS Completion status code 

FAB STV Completion status value 

NAM DID Directory identifier 

NAM DVI Device identifier 

NAM ESL Expanded string length (bytes) 
NAM FID File identifier 


(Continued on next page) 
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Table 5-16 (Cont.): ERASE Output Fields 


Block Field Description 


NAM FNB File specification mask 


NBSNOD Node in file string or default string 

NBSDEV Device in file string or default string 

NBSDIR Directory in file string or default string 

NBSQUO Quoted string in file string or default 
string 

NBSNAM File name in file string or default string 

NBSTYP File type in file string or default string 

NBSVER File version in file string or default 
string 

NBSWDI Wildcard directory in file string or 
default string 

NBSWNA Wildcard file name in file string or 
default string 

NBSWTY Wildcard file type in file string or 
default string 

NBSWVE Wildcard file version in file string or 
default string 

NBSWCH Wildcard context established 


NAM RSL Resultant string length (bytes) 
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5.9 SEXTEND MACRO 


The SEXTEND macro calls the EXTEND operation routine to extend the 
allocation for an open file. 


FORMAT 
The format for the SEXTEND is: 
SEXTEND fabaddr[,[erraddr] [,sucaddr] ] 


where fabaddr is the address of the FAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 
You must supply a FAB for the EXTEND operation. 


For each ALL block that you supply, the EXTEND operation extends’ the 
corresponding area as described in the ALL block. You need not supply 
an ALL block for an area that you do not want to extend, but- each 
supplied ALL block must correspond to an area in the file; this means 
that you can supply ALL blocks for areas other than area 0 only for an 
indexed file opened for record access. 


To supply XABs (ALL, DAT, KEY, PRO, and SUM. blocks) for the EXTEND 
operation, specify the address of the first XAB in the l-word XAB 
field of the FAB; specify the address of the next XAB (if any) in the 
l-word NXT field of each XAB; specify 0 in the NXT field of the last 
XAB. 


All KEY blocks must be together in the chain of XABs, and must be in 
ascending order (by the index reference number in the l-byte REF field 
of the KEY block); the index reference numbers need not be 
consecutive. 


All ALL blocks must be together in the chain of XABs, and must be in 
ascending order (by the area identifier in the l-byte AID field of the 
ALL block); the area identifiers need not be consecutive. 


Multiple DAT, PRO, or SUM XABS are illegal. 


OPTIONS 


Internal File Identifier 


The EXTEND operation reads the internal file identifier from_ the 
l-word IFI field of the FAB. This is the value written by the CREATE 
or OPEN operation that opened the file. 


Area 0 Extended by FAB 


If you supply no ALL blocks, specify the size (in blocks) of the 
extension in the 2-word ALQ field of the FAB. 


If you want the extension to be contiguous within itself (it will not 
necessarily be contiguous with the file), set the FBSCTG mask in the 
l-word FOP field of the FAB; if you do not set this mask, the 
extension is not necessarily contiguous within itself. 
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Areas Extended by ALL Blocks 


If you supply ALL blocks, the EXTEND operation ignores the ALQ field 
of the FAB, and extends each area specified in an ALL block. Specify 
each area to be extended by supplying an ALL block with the area 
number in the l-byte AID field of the ALL block. Specify the size of 
the extension (in blocks) for the area in the 2-word ALQ field of the 
ALL block. 


If you want the area extension to be contiguous within itself (it will 
not be contiguous with the previous area extent), set the XBSCTG mask 
in the l-byte AOP field of the ALL block. If you do not set this 
mask, the extension will not necessarily be contiguous within itself. 


If you want to place the extension at a specific location, specify an 
alignment mask in the 1l-byte ALN field of the ALL block; if you 
specify 0, the EXTEND operation places the extension at any convenient 
location. The symbols for alignment masks are: 


XBSLBN Logical block alignment 
XBSVBN Virtual block alignment 


Specify the number of the logical block or virtual block in the 2-word 
LOC field of the ALL block, 


If you specify logical block alignment, and if you want the extension 
placed only at the location you specify, set the XBSHRD mask in the 
l-byte AOP field of the ALL block. If you do not set this mask, the 
EXTEND operation selects an alternate location if the specified 
location is not available. If you do set this mask, the EXTEND 
operation returns an error completion if the specified location is not 
available. 


STREAM CONTEXT 


The EXTEND operation does not affect stream context. 


RETURNED VALUES 


Extension Sizes 


The EXTEND operation returns the size (in blocks) of each extension it 
makes. If you extended only area 0 using FAB fields, the EXTEND 
operation writes the size of the extension in the 2-word ALQ field of 
the FAB. If you extended areas using ALL blocks, the EXTEND operation 
writes the size of each area extension in the 2-word ALQ field of the 
ALL block for the area. 


Completion Status and Value 

The EXTEND operation returns completion status in the l-word STS field 
of the FAB and returns a completion value in the l-word STV field of 
the FAB. Appendix A lists completion status symbols and values. 
CHECKLISTS 

Table 5-17 lists control block fields that are input to the EXTEND 


operation. Table 5-18 lists control block fields that are output by 
the EXTEND operation. 
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Block Field 


ALL 
ALL 


Block Field Description 


ALL 
FAB 
FAB 
FAB 


AID 
ALN 


ALQ 
AOP 


LOC 
NXT 
NXT 
ALQ 
FOP 


LET 
XAB 
NXT 
NXT 
REF 
NXT 


ALQ 
ALQ 
STS 
STV 


Table 5-17: EXTEND Input Fields 
Description 
Area number 
Area extension alignment request 


XBSLBN Logical block alignment 
XBSVBN Virtual block alignment 


Area allocation extension request size (blocks) 


Area option mask 


XBSCTG Contiguous area extension request 
XBSHRD Area extension hard location request 


Area extension location request 
Next XAB address 
Next XAB address 


File allocation extension request size 


File processing option mask 


(blocks) 


FBSCTG Contiguous file extension request 


Internal file identifier 
XAB address 

Next XAB address 

Next XAB address 

Index reference number 


Table 5-18: EXTEND Output Fields 


Area allocation extension actual size 
File allocation extension actual size 
Completion status code 

Completion status value 


Next XAB address 


(blocks) 
(blocks) 
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5.10 S$FIND MACRO (SEQUENTIAL ACCESS) 
The SFIND macro calls the FIND operation routine to transfer a_ recc 
(or part of a record) from a file to anI/O buffer. The FI 
Operation transfers the entire record if the file is relative c 
indexed, or if it has blocked records; it may transfer only part or 
the record if the record spans block boundaries. The FIND operation 
does not transfer the record to a user buffer. 
The target of a sequential-access FIND operation is the next record 
(for an indexed file, the next record under the current index). 
FORMAT 
The format for the SFIND is: 

SFIND rabaddr[,[erraddr] [,sucaddr] } 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the FIND operation. 


OPTIONS 


Internal Stream Identifier 


The FIND operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 


Asynchronous Operation 


If you want to execute the FIND operation asynchronously, set the 
RBSASY mask in the 1-word ROP field of the RAB; if you do not set 
this mask, the FIND operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


Sequential Access 


Specify the RBSSEQ code in the l-byte RAC field of the RAB. 


STREAM CONTEXT 


The current-record context after a sequential access FIND operation is 
the found record; the next-record context is the record following the 
found record (for an indexed file, the next record under the current 
index). If the FIND operation returns an error completion, the 
current-record context is undefined, and the next-record context is 
unchanged. 
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RETURNED VALUES 


RRN 

For a relative file or for a sequential disk file with fixed-length 
records, a sequential-access FIND operation returns’ the relative 
record number (RRN) for the found record in the 2-word BKT field of 
the RAB. 

RFA 

The FIND operation returns the record file address (RFA) for the found 
record in the 3-word RFA field of the RAB. 

Completion Status and Value 

The FIND operation returns completion status in the l-word STS field 
of the RAB and returns a completion value in the l-word STV field of 
the RAB. Appendix A lists completion status symbols and values. 
CHECKLISTS 

Table 5-19 lists control block fields that are input to the FIND 


operation. Table 5-20 lists control block fields that are output by 
the FIND operation. 


Table 5-19: FIND (Sequential Access) Input Fields 


Block Field Description 
RAB ISI Internal stream identifier 
RAB RAC Record access code 
RBSSEQ Sequential access 
RAB ROP Record processing option mask 


RBSASY Asynchronous operation 


Table 5-20: FIND (Sequential Access) Output Fields 


Block Field Description 


RAB BKT Relative record number (RRN) 
RAB RFA Record file address 

RAB STS Completion status code 

RAB STV Completion status value 
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5.11 $FIND MACRO (KEY ACCESS) 


The SFIND macro calls the FIND operation routine to transfer a record 
(or part of a record) from a sequential disk file (with fixed-length 
records), a relative file, or an indexed file to an I/O buffer. The 
FIND operation transfers the entire record if the file is relative or 
indexed, or if it has blocked records; it may transfer only part of 
the record if the record spans block boundaries. The FIND operation 
does not transfer the record to a user buffer. 


The target of a key-access FIND operation is the record having the 
specified key (under the specified match criterion). For a relative 
file or for a sequential disk file with fixed-length records, the key 
is a relative record number (RRN); for an indexed file, the key is an 
index key under the specified index. 
FORMAT 
The format for the SFIND is: 

SFIND rabaddr[,[erraddr][,sucaddr] ] 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the FIND operation. 


OPTIONS 


Internal Stream Identifier 

The FIND operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 

Asynchronous Operation 

If you want to execute the FIND operation asynchronously, set the 
RBSASY mask in the 1-word ROP field of the RAB; if you do not set 
this mask, the FIND operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


Key Access 


Specify the RBSKEY code in the l-byte RAC field of the RAB. 


Key of Reference (Indexed File) 


Specify the key of reference in the l-byte KRF field of the RAB. The 
key of reference is the reference number (REF field of KEY block) for 
the index you want to use for the FIND operation. 
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Key 


Specify a buffer containing the key for the record to be found: 
specify the address of the key buffer in the l-word KBF field of the 
RAB, and specify the size of the key in the l-byte KSZ field of the 
RAB. 


For a relative file, or for a sequential file with fixed-length 
records, specify a 4-byte binary relative record number (RRN) as the 
key, and specify the key size as 0 or 4. 


For an indexed file, specify a key of the same type as the key for the 
current index, and specify a key size no greater than the key size for 
the current index. For a nonstring key, the specified key size must 
be the key size defined for the index (or, equivalently, 0); for a 
string key, if you specify a key size smaller than the key size _ for 
the index, the FIND operation searches for a record whose key begins 
with the specified partial key (under the specified key criterion). 


Key Criterion 


Specify a key-criterion mask in the l-word ROP field of the RAB. The 
symbols for key-criterion masks are: 


RBSKGE Greater-than-or-equal key criterion 
RBSKGT Greater-than key criterion 


If you specify the key-greater criterion, the FIND operation searches 
for the first record whose key is greater than the key you specify; 
if you specify the key-greater-or-equal criterion, the FIND operation 
searches for the first record whose key is greater than or equal to 
the key you specify; if you specify neither criterion, the FIND 
Operation searches for a record whose key exactly matches the key you 
specify. (It is illegal to specify both criteria.) 


STREAM CONTEXT 
The current-record context after a key access FIND operation is’ the 
found record; the next-record context is unchanged. If the FIND 


operation returns an error completion, the current-record context is 
undefined, and the next-record context is unchanged. 


RETURNED VALUES 


RFA 


The FIND operation returns the record file address (RFA) for the found 
record in the 3-word RFA field of the RAB. 


RRN 


For a relative file or for a sequential disk file with fixed-length 
records, the FIND operation returns the RRN of the found record in the 
2-word BKT field of the RAB. 
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Completion Status and Value 
The FIND operation returns completion status in the l-word STS field 


of the RAB and returns a completion value in the l-word STV field of 
the RAB. Appendix A lists completion status symbols and values. 


CHECKLISTS 

Table 5-21 lists control block fields that are input to the FIND 
Operation. Table 5-22 lists control block fields that are output by 
the FIND operation. 


Table 5-21: FIND (Key Access) Input Fields 


Block Field Description 


RAB ISI Internal stream identifier 
RAB KBF Key buffer address 

RAB KRF Key of reference 

RAB KSZ Key size (bytes) 

RAB RAC Record access code 


RBSKEY Key access 
RAB ROP Record processing option mask 
RBSASY Asynchronous operation 


RBSKGE Greater-than-or-equal key criterion 
RBSKGT Greater-than key criterion 


Table 5-22: FIND (Key Access) Output Fields 


Block Field Description 


RAB BKT Relative record number (RRN) 
RAB RFA Record file address 

RAB STS Completion status code 

RAB STV Completion status value 
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5.12 SFIND MACRO (RFA ACCESS) 
The S$FIND macro calls the FIND operation routine to transfer a record 
(Or part of a record) from a file to an I/O buffer. The FIND 
Operation transfers the entire file if the file is relative or 
indexed, or if it has blocked records; it may transfer only part of 
the record if the record spans block boundaries. The FIND operation 
does not transfer the record to a user buffer. 
The target of an RFA-access FIND operation is the record having the 
record file address (RFA) you specify. 
FORMAT 
The format for the SFIND is: 

SFIND rabaddr[,[erraddr] [,sucaddr] ] 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the FIND operation. 


OPTIONS 


Internal Stream Identifier 

The FIND operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 

Asynchronous Operation 

If you want to execute the FIND operation asynchronously, set the 
RBSASY mask in the Il-word ROP field of the RAB; if you do not set 
this mask, the FIND operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


RFA Access 


Specify the RBSRFA code in the l-byte RAC field of the RAB. 


RFA 


Specify the RFA for the record to be found in the 3-word RFA field of 
the RAB. 


STREAM CONTEXT 


The current-record context after an RFA access FIND operation is’ the 
found record (for an indexed file, in the context of the primary 
index); the next-record context is unchanged. If the FIND operation 
returns an error completion, the current-record context is undefined, 
and the next-record context is unchanged. 
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RETURNED VALUES 


RRN 
For a relative file or for a sequential disk file with fixed-length 
records, the FIND operation returns the RRN of the found record in the 
2-word BKT field of the RAB. 
Completion Status and Value 
The FIND operation returns completion status in the l-word STS field 
of the RAB and returns a completion value in the l-word STV field of 
the RAB. Appendix A lists completion status symbols and values. 
CHECKLISTS 
Table 5-23 lists control block fields that are input to the FIND 
operation. Table 5-24 lists control block fields that are output by 
the FIND operation. 
Table 5-23: FIND (RFA Access) Input Fields 
Block Field Description 
RAB ISI Internal stream identifier 
RAB RAC Record access code 


RBSRFA RFA access 


RAB RFA Record file address 
RAB ROP Record processing option mask 


RBSASY Asynchronous operation 


Table 5-24: FIND (RFA Access) Output Fields 


Block Field Description 


RAB BKT Relative record number (RRN) 
RAB STS Completion status code 
RAB STV Completion status value 
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5.13 SFLUSH MACRO 
The SFLUSH macro calls the FLUSH operation routine to write any 
unwritten buffers for a stream. The FLUSH operation does not affect 
stream context, except that the current-record context is undefined 
for a following TRUNCATE or UPDATE operation. 
Note one special case: if a file was opened for deferred writing 
(FBSDFW set in the FOP field of the FAB for the CREATE or OPEN 
Operation), and was not opened for write sharing (FBSWRI cleared in 
the SHR field of the FAB), then a buffer may be controlled by a 
different stream, and it will not be written by the FLUSH operation. 
FORMAT 
The format for the SFLUSH is: 

SFLUSH rabaddr[,[erraddr] [,sucaddr] } 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the FLUSH operation. 
OPTIONS 


Internal Stream Identifier 


The FLUSH operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 


Asynchronous Operation 


If you want to execute the FLUSH operation asynchronously, set the 
RBSASY mask in the l-word ROP field of the RAB; if you do not set 
this mask, the FLUSH operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


STREAM CONTEXT 
The FLUSH operation does not affect stream context, except that the 


current-record context is undefined for a following TRUNCATE or UPDATE 
operation. 


RETURNED VALUES 


Completion Status and Value 


The FLUSH operation returns completion status in the l-word STS field 
of the RAB and returns a completion value in the l-word STV field of 
the RAB. Appendix A lists completion status symbols and values. 
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CHECKLISTS 
Table 5-25 lists control block fields that are input to the FLUSH 


operation. Table 5-26 lists control block fields that are output by 
the FLUSH operation. 


Table 5-25: FLUSH Input Fields 


Block Field Description 


RAB ISI Internal stream identifier 
RAB ROP Record processing option mask 


RBSASY Asynchronous operation 
Table 5-26: FLUSH Output Fields 
Block Field Description 


RAB STS Completion status code 
RAB STV Completion status value 
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5.14 S$FREE MACRO 
The SFREE macro calls the FREE operation routine to free a_ locked 
bucket for a stream. The FREE operation does not affect stream 
context, except that the current-record context is undefined for a 
following DELETE, TRUNCATE, or UPDATE operation. 
FORMAT 
The format for the SFREE is: 

SFREE rabaddr[,[erraddr] [,sucaddr] ] 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the FREE operation. 


OPTIONS 


Internal Stream Identifier 


The FREE operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 


Asynchronous Operation 


If you want to execute the FREE operation asynchronously, set the 
RBSASY mask in the 1l-word ROP field of the RAB; if you do not set 
this mask, the FREE operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


STREAM CONTEXT 
The FREE operation does not affect stream context, except that the 


current-record context is undefined for a following DELETE, TRUNCATE, 
or UPDATE operation. 


RETURNED VALUES 


Completion Status and Value 


The FREE operation returns completion status in the l-word STS field 
of the RAB and returns a completion value in the l-word STV field of 
the RAB. Appendix A lists completion status symbols and values. 


CHECKLISTS 
Table 5-27 lists control block fields that are input to the FREE 


operation, Table 5-28 lists control block fields that are output by 
the FREE operation. 


ee 


Block Field 


a 


RAB 
RAB 


ee, 


Block Field 


—-—. 


RAB 
RAB 


ISI 
ROP 


STS 
STV 
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Table 5-27: FREE Input Fields 


Description 


Internal stream identifier 
Record processing option mask 


RBSASY Asynchronous operation 
Table 5-28: FREE Output Fields 
Description 


Completion status code 
Completion status value 
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5-15 $GET MACRO (SEQUENTIAL ACCESS) 


The $GET macro calls the GET operation routine to transfer a_ record 
from a file to an I/O buffer and to a user buffer. 


The target of a sequential-access GET operation depends on whether the 
previous operation was a FIND operation: 


e If the previous operation was a successful FIND operation, the 
target of a sequential-access GET operation is the current 
record (or the first following record if the current’ record 
was deleted or its key changed in the interim). 

e If the previous operation was not a successful FIND operation, 
the target of a sequential-access GET operation is the next 
record (for an indexed file, the next record under the current 
index). 

FORMAT 
The format for the SGET is: 

SGET rabaddr[,[erraddr] [,sucaddr] ] 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the GET operation. 
OPTIONS 


Internal Stream Identifier 


The GET operation reads the internal stream identifier from the l-word 
ISI field of the RAB. 


Asynchronous Operation 


If you want to execute the GET operation asynchronously, set the 
RBSASY mask in the 1l-word ROP field of the RAB; if you do not set 
this mask, the GET operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


Sequential Access 


Specify the RBSSEQ code in the 1l-byte RAC field of the RAB. 


User Buffer 


Specify a user buffer for the GET operation. The GET operation copies 
the retrieved record to this buffer if you do not specify locate mode 
(see next section, Locate Mode); the GET operation may copy the 
retrieved record to this buffer even if you specify locate mode. 
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Specify the address of the user buffer in the l-word UBF field of the 
RAB, and specify the size (in bytes) of the user buffer in the l-word 
USZ field of the RAB. 


If the file is in VFC record format, specify the address of a buffer 
for the fixed-length portion of the record in the l-word RHB field of 
the RAB. 


Locate Mode 


If you want the GET operation to use locate mode (in which the’ record 
may not be transferred to the user buffer), set the RBSLOC mask in the 
l-word ROP field of the RAB; if you do not set this mask, the record 
is transferred to the user buffer. 


STREAM CONTEXT 


The current-record context after a sequential access GET operation is 
the retrieved record; the next-record context is the record following 
the retrieved record. 


If the GET operation returns an error completion, the current-record 
context is undefined, and the next-record context is unchanged. 


RETURNED VALUES 


Record 


The GET operation returns the address and size of the retrieved record 
in the 1l-word RBF field of the RAB, and the size (in bytes) of the 
record in the l-word RSZ field of the RAB. 


If you did not specify locate mode for the GET operation, the record 
address returned in the RBF field is the address you specified in the 
UBF field; if you specified locate mode, the record address’ returned 
in the RBF field is either the address you specified in the UBF field, 
or the address of a location in an I/0 buffer. 


If the file is in VFC format, the GET operation writes the 
fixed-length portion of the record in the buffer you specified in the 
RHB field of the RAB. 


RRN 


For a relative file or for a sequential disk file with fixed-length 
records, a sequential-access GET operation returns the relative record 
number (RRN) for the retrieved record in the 2-word BKT field of the 
RAB. 


RFA 


The GET operation returns the record file address’ (RFA) for the 
retrieved record in the 3-word RFA field of the RAB. 
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Completion Status and Value 


The GET operation returns completion status in the l-word STS field of 
the RAB and returns a completion value in the l-word STV field of the 
RAB. Appendix A lists completion status symbols and values. 


CHECKLISTS 


Table 5-29 lists control block fields that are input to the GET 
operation. Table 5-30 lists control block fields that are output by 
the GET operation. 


Table 5-29: GET (Sequential Access) Input Fields 


NNN MA 


Block Field Description 
RAB ISI Internal stream identifier 
RAB RAC Record access code 
RBSSEQ Sequential access 


RAB RHB VFC control buffer address 
RAB ROP Record processing option mask 


RBSASY Asynchronous operation 
RBSLOC Locate mode 


RAB UBF User buffer address 
RAB USZ User buffer size (bytes) 


Table 5-30: GET (Sequential Access) Output Fields 


Block Field Description 


RAB BKT Relative record number (RRN) 
RAB RBF Record buffer address 

RAB RFA Record file address 

RAB RSZ Record size (bytes) 

RAB STS Completion status code 

RAB STV Completion status value 
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5.16 S$GET MACRO (KEY ACCESS) 
The SGET macro calls the GET operation routine to transfer a record 
from a sequential disk file (with fixed-length records), a relative 
file, or an indexed file to an I/O buffer and to a user buffer. 
The target of a key-access GET operation is the record having the 
specified key (under the specified match criterion). For a relative 
file or for a sequential disk file with fixed-length records, the key 
is a relative record number (RRN); for an indexed file, the key is an 
index key under the specified index. 
FORMAT 
The format for the SGET is: 
SGET rabaddr[,[erraddr] [,sucaddr] } 

where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the GET operation. 


OPTIONS 


Internal Stream Identifier 


The GET operation reads the internal stream identifier from the l-word 
ISI field of the RAB. 


Asynchronous Operation 


If you want to execute the GET operation asynchronously, set the 
RBSASY mask in the 1l-word ROP field of the RAB; if you do not set 
this mask, the GET operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


Key Access 


Specify the RBSKEY code in the l-byte RAC field of the RAB. 


Key of Reference (Indexed File) 


Specify the key of reference in the l-byte KRF field of the RAB. The 
key of reference is the reference number (REF field of KEY block) for 
the index you want to use for the GET operation. 


Key 


Specify a buffer containing the key for the record to be retrieved: 
specify the address of the key buffer in the l-word KBF field of the 
RAB, and specify the size of the key in the l-byte KSZ field of the 
RAB. 
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For a relative file or for a sequential file with fixed-length 
records, specify a 4-byte binary relative record number (RRN) as the 
key, and specify the key size as 0 or 4. 


For an indexed file, specify a key of the same type as the key for the 
current index, and specify a key size no greater than the key size for 
the current index. For a nonstring key, the specified key size must 
be the key size defined for the index (or, equivalently, 0); for a 
string key, if you specify a key size smaller than the key size for 
the index, the GET operation searches for a record whose key begins 
with the specified partial key (under the specified key criterion). 


Key Criterion 


Specify a key-criterion mask in the l-word ROP field of the RAB. The 
symbols for key-criterion masks are: 


RBSKGE Greater-than-or-equal key criterion 
RBSKGT Greater-than key criterion 


If you specify the key-greater criterion, the GET operation searches 
for the first record whose key is greater than the key you specify; 
if you specify the key-greater-or-equal criterion, the GET operation 
searches for the first record whose key is greater than or equal to 
the key you specify; if you specify neither criterion, the GET 
operation searches for a record whose key exactly matches the key you 
specify. 


User Buffer 


Specify a user buffer for the GET operation. The GET operation copies 
the retrieved record to this buffer if you do not specify locate mode 
(see next section, Locate Mode); the GET operation may copy the 
retrieved record to this buffer even if you specify locate mode. 


Specify the address of the user buffer in the l-word UBF field of the 
RAB, and specify the size (in bytes) of the user buffer in the l-word 
USZ field of the RAB. 


If the file is in VFC record format, specify the address of a buffer 
for the fixed-length portion of the record in the l-word RHB field of 
the RAB. 


Locate Mode 


If you want the GET operation to use locate mode (in which the record 
May not be transferred to the user buffer), set the RBSLOC mask in the 
l-word ROP field of the RAB; if you do not set this mask, the record 
is transferred to the user buffer. 


STREAM CONTEXT 


The current-record context after a key access GET operation is’ the 
retrieved record; the next-record context is the record following the 
retrieved record. 


If the GET operation returns an error completion, the current-record 
context is undefined, and the next-record context is unchanged. 
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RETURNED VALUES 


Record 


The GET operation returns the address and size of the retrieved record 
in the l-word RBE field of the RAB, and the size (in bytes) of the 
record in the l-word RSZ field of the RAB. 


If you did not specify locate mode for the GET operation, the record 
address returned in the RBF field is the address you specified in the 
UBF field. If you specified locate mode, the record address returned 
in the RBF field is either the address you specified in the UBF field, 
or the address of a location in an I/0 buffer. 


If the file is in VFC format, the GET operation writes the 
fixed-length portion of the record in the buffer you specified in the 
RHB field of the RAB. 

RRN 

For a relative file or for a sequential disk file with fixed-length 
records, a key-access GET operation returns the relative record number 
(RRN) for the retrieved record in the 2-word BKT field of the RAB. 

RFA 

The GET operation returns the record file address (RFA) for the 
retrieved record in the 3-word RFA field of the RAB. 

Completion Status and Value 

The GET operation returns completion status in the l-word STS field of 
the RAB and returns a completion value in the l-word STV field of the 
RAB. Appendix A lists completion status symbols and values. 
CHECKLISTS 

Table 5-31 lists control block fields that are input to the GET 


operation. Table 5-32 lists control block fields that are output by 
the GET operation. 
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Table 5-3l: GET (Key Access) Input Fields 


Block Field Description 


RAB LS 1 Internal stream identifier 
RAB KBF Key buffer address 

RAB KRF Key of reference 

RAB KSZ Key size (bytes) 

RAB RAC Record access code 


RBS KEY Key access 


RAB RHB VFC control buffer address 
RAB ROP Record processing option mask 


RBSASY Asynchronous operation 
RBSKGE Greater—than-or-equal key criterion 
RBSKGT Greater-than key criterion 
RBSLOC Locate mode 
RAB UBF User buffer address 
RAB USZ User buffer size (bytes) 
Table 5-32: GET (Key Access) Output Fields 


Block Field Description 


RAB BRKT Relative record number (RRN) 
RAB RBF Record buffer address 

RAB RFA Record file address 

RAB RSZ Record size (bytes) 

RAB STS Completion status code 


RAB STV Completion status value 
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5.17 $GET MACRO (RFA ACCESS) 


The SGET macro calls the GET operation routine to transfer a_ record 
from a file to an I/O buffer and to a user buffer. 


The target of an RFA-access GET operation is the record having the 
-record file address (RFA) you specify. 
FORMAT 
The format for the S$GET is: 

SGET rabaddr[,[(erraddr] [,sucaddr] } 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 
CONTROL BLOCKS 


You must supply a RAB for the GET operation, 


OPTIONS 


Internal Stream Identifier 


The GET operation reads the internal stream identifier from the l-word 
ISI field of the RAB. 


Asynchronous Operation 


If you want to execute the GET operation asynchronously, set the 
RBSASY mask in the 1l-word ROP field of the RAB; if you do not set 
this mask, the GET operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


RFA Access 


Specify the RBSRFA code in the l-byte RAC field of the RAB. 


RFA 


Specify the RFA for the record to be retrieved in the 3-word RFA field 
of the RAB. 


User Buffer 


Specify a user buffer for the GET operation. The GET operation copies 
the retrieved record to this buffer if you do not specify locate mode 
(see next section, Locate Mode); the GET operation may copy the 
retrieved record to this buffer even if you specify locate mode. 


Specify the address of the user buffer in the l-word UBF field of the 
RAB, and specify the size (in bytes) of the user buffer in the l-word 
USZ field of the RAB. 
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If the file is in VFC record format, specify the address of a buffer 
for the fixed-length portion of the record in the l-word RHB field of 
the RAB. 


Locate Mode 


If you want the GET operation to use locate mode (in which the record 
may not be transferred to the user buffer), set the RBSLOC mask in the 
l-word ROP field of the RAB; if you do not set this mask, the record 
is transferred to the user buffer. 


STREAM CONTEXT 


The current-record context after an RFA access GET operation is’ the 
retrieved record (for an indexed file, in the context of the primary 
index); the next-record context is the record following the retrieved 
record. If the GET operation returns an error completion, the 
current-record context is undefined, and the next-record context is 
unchanged. 


RETURNED VALUES 


Record 


The GET operation returns the address and size of the retrieved record 
in the 1l-word RBF field of the RAB, and the size (in bytes) of the 
record in the l-word RSZ field of the RAB. 


If you did not specify locate mode for the GET operation, the record 
address returned in the RBF field is the address you specified in the 
UBF field. If you specified locate mode, the record address returned 
in the RBF field is either the address you specified in the UBF field, 
or the address of a location in an I/0 buffer. 


If the file is in VFC format, the GET operation writes the 
fixed-length portion of the record in the buffer you specified in the 
RHB field of the RAB. 


RRN 


For a relative file or for a sequential disk file with fixed-length 
records, an RFA-access GET operation returns’ the relative record 
number (RRN) for the retrieved record in the 2-word BKT field of the 
RAB. 


Completion Status and Value 

The GET operation returns completion status in the l-word STS field of 
the RAB and returns a completion value in the l-word STV field of the 
RAB. Appendix A lists completion status symbols and values. 
CHECKLISTS 

Table 5-33 lists control block fields that are input to the GET 


operation. Table 5-34 lists control block fields that are output by 
the GET operation. 
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Table 5-33: GET (RFA Access) Input Fields 


Block Field Description 


RAB ISI Internal stream identifier 
RAB RAC Record access code 


RBSRFA RFA access 


RAB RFA Record file address 
RAB RHB VFC control buffer address 
RAB ROP Record processing option mask 


RBSASY Asynchronous operation 
RBSLOC Locate mode 


RAB UBF User buffer address 
RAB USZ User buffer size (bytes) 


Table 5-34: GET (RFA Access) Output Fields 


Block Field Description 


RAB BKT Relative record number (RRN) 
RAB RBF Record buffer address 

RAB RSZ Record size (bytes) 

RAB STS Completion status code 

RAB STV Completion status value 
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5.18 SNXTVOL MACRO 
The S$NXTVOL macro calls the NXTVOL operation routine to advance’ the 
context for a stream to the beginning of the next magtape volume. 
FORMAT 
The format for the SNXTVOL is: 

SNXTVOL rabaddr[,f[erraddr] [,sucaddr] ] 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 
CONTROL BLOCKS 


You must supply a RAB for the NXTVOL operation. 


OPTIONS 


Internal Stream Identifier 


The NXTVOL operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 


Asynchronous Operation 


If you want to execute the NXTVOL operation asynchronously, set the 
RBSASY mask in the 1-word ROP field of the RAB; if you do not set 
this mask, the NXTVOL operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


STREAM CONTEXT 
The NXTVOL operation destroys the current-record context; the 
next-record context after the NXTVOL operation is the first record of 


the new volume (or end-of-file, if there are no records on the new 
volume). 


RETURNED VALUES 


Completion Status and Value 


The NXTVOL operation returns completion status in the l-word STS field 
of the RAB and returns a completion value in the l-word STV field of 
the RAB. Appendix A lists completion status symbols and values. 


CHECKLISTS 
Table 5-35 lists control block fields that are input to the NXTVOL 


operation. Table 5-36 lists control block fields that are output by 
the NXTVOL operation. 


Block Field 


RAB 
RAB 


Block Field 


RAB 
RAB 


ISI 
ROP 


sTS 
STV 
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Table 5-35: NXTVOL Input Fields 


Description 


Internal stream identifier 
Record processing option mask 


RBSASY Asynchronous operation 


Table 5-36: NXTVOL Output Fields 


Description 


Completion status code 
Completion status value 


SNXTVOL MACRO 
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5.19 SOPEN MACRO 


The SOPEN macro calls the OPEN operation routine to open a file _ for 
processing by the calling task. 


FORMAT 
The format for the SOPEN is: 
SOPEN fabaddr[,[erraddr] [,sucaddr] ] 


where fabaddr is the address of the FAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 
You must supply a FAB for the OPEN operation. 


If you supply a NAM block and specify open by NAM block, the OPEN 
Operation reads NAM block fields to obtain identifiers for the target 
file, 


To supply a NAM block for the OPEN operation, specify the address of 
the NAM block in the l-word NAM field of the FAB. 


For each ALL block that you supply, the OPEN operation fills its 
fields with values describing the corresponding area (if any) of the 
file. You need not supply an ALL block for every area of the file. 
(If you are opening the file for block access, the OPEN operation 
writes information describing the file as a whole in the all block for 
area 0.) 


For each KEY block that you supply, the OPEN operation fills its 
fields with values describing the corresponding index (if any) for the 
file. You need not supply a KEY block for every index of tthe file. 
(If you are opening the file for block access, the OPEN operation does 
not write in KEY blocks.) 


If you supply a PRO block for a disk file, the OPEN operation fills 
its fields with values showing the owner and protection for the file. 


If you supply a DAT block for a disk file, the OPEN operation fills 
its fields with values showing the creation date, expiration date, 
revision date, and revision number for the file. 


If you supply a SUM block for a relative or indexed file, the OPEN 
operation fills its fields with values showing the number of areas and 
indexes for the file, and with its prologue version number. (If you 
are opening the file for block access, the OPEN operation returns the 
number of areas and number of keys as 0, and does not’ return the 
prologue version number.) 


This information is especially useful if you do not know how many 
areas or keys an indexed file has when you open it. If you supply a 
SUM block for the OPEN operation, you can get the number of areas’ and 
number of indexes from its fields, and then supply the correct number 
of ALL blocks and KEY blocks for the DISPLAY operation. 
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To supply XABs (ALL, DAT, KEY, PRO, and SUM blocks) for the OPEN 
operation, specify the address of the first XAB in the l-word XAB 
field of the FAB; specify the address of the next XAB (if any) in the 
l-word NXT field of each XAB; specify 0 in the NXT field of the last 
XAB. 


All KEY blocks must be together in the chain of XABs, and must be in 
ascending order (by the index reference number in the l-byte REF field 
of the KEY block); the index reference numbers need not be 
consecutive. 


All ALL blocks must be together in the chain of XABs, and must be in 
ascending order (by the area identifier in the l-byte AID field of the 
ALL block); the area identifiers need not be consecutive. 


Multiple DAT, PRO, or SUM XABs are illegal. 


OPTIONS 


File Specification (Nonwildcard OPEN Operation) 


The OPEN operation constructs the full file specification from the 
file string, the default string (which contributes only elements not 
present in the file string), and RMS-11 defaults (which contribute 
elements not present in either the file string or the default string). 


RMS-1ll defaults are: 


e Device -- The device to which the specified logical channel is 
assigned, or SY: if the specified logical channel is not 
assigned to any device. 


@e Directory -- The current directory for the task. 
e Name, type, version -- Defaulted to null. 
The file string and the default string must not contain wildcards. 


Specify the address of the file string in the l-word FNA field of the 
FAB. Specify the size (in bytes) of the file string in the l-byte FNS 
field of the FAB; if you specify 0O in the FNS field, the OPEN 
operation uses no file string. 


Specify the address of the default string in the l-word DNA field of 
the FAB. Specify the size (in bytes) of the default string in the 
l-byte DNS field of the FAB; if you specify 0 in the DNS field, the 
OPEN operation uses no default string. 


If you set the FBSFID mask in the l-word FOP field of the FAB. and 
supply a NAM block, the OPEN operation reads the device identifier 
from the 2-word DVI field of the NAM block; if this value is nonzero, 
the specified device overrides the device in the merged string. 


In the same circumstance, the OPEN operation reads the directory 
identifier from the 3-word DID field of the NAM block; if this value 
is nonzero, the specified directory overrides the directory in the 
merged string. 


In the same circumstance, the OPEN operation reads the file identifier 
from the 3-word FID field of the NAM block; if this value is zero, 
the specified file overrides any directory, name, type, and version 
elements previously obtained. 
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Open with Wildcard Context 


If you want to open a file that was found by a wildcard SEARCH 
operation (using the FAB and NAM block that the SEARCH operation 
used), set the FBSFID mask in the l-word FOP field of the FAB; this 
causes the OPEN operation to open the file without altering wildcard 
context. 


Expanded String Buffer 


If you want the OPEN operation to return the expanded string for the 
opened file, provide a buffer for the string. Specify the address of 
the expanded string buffer in the l-word ESA field of the NAM _ block 
and its size (in bytes) in the l-byte ESS field of the NAM block; if 
you specify 0 in the ESS field, the OPEN operation does not return the 
expanded string. 


Key Name Buffer 


If you want the key name string for an index returned to a buffer, 
supply a KEY block for the index. Specify the index reference number 
in the l-byte REF field of the KEY block, and specify the address of a 
32-byte buffer in the l-word KNM field of the KEY block. If you do 
not supply a KEY block for an index, or if you specify 0 in its KNM 
field, the OPEN operation does not return the key name string. 


While-Open Default Extension Sizes 


If you want to override the default extension size for the file while 
it is open, specify the while-open default file extension size (in 
blocks) in the l-word DEQ field of the FAB. If you specify 0, the 
OPEN operation does not establish a while-open default extension size 
for the file; instead, it uses the permanent default extension size. 


The while-open default extension size for a file remains in _ force 
while the file is open, but does not change the file extension size 
established when the file was created. 


Private Buffer Pool 


If you want the OPEN operation to use a private buffer pool instead of 
the central buffer pool, specify the address of the (word-aligned) 
private buffer pool in the l-word BPA field of the FAB, and its’ size 
(in bytes) in the l-word BPS field of the FAB; this size must be a 
multiple of 4. 


If you specify 0 in either the BPA field or the BPS field, the OPEN 
operation uses the central buffer pool. 


The pool that the OPEN operation uses is also used by the DISPLAY and 
EXTEND operations, and by stream and record or block operations while 
the file is open. 


Logical Channel 


Specify the logical channel for the OPEN operation in the l-byte LCH 
field of the FAB. The logical channel number must not be the same as 
the logical channel number for any already-open file, and must not be 
0. 
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The logical channel that the OPEN operation uses is also used by the 
DISPLAY and EXTEND operations, and by stream and record or block 
operations while the file is open. 


Retrieval Pointers 


Specify the number of retrieval pointers for the open file in the 
l-byte RTV field of the FAB. If you specify 0, the OPEN operation 
uses the operating system default; if you specify -l, the OPEN 
operation maps as much of the file as possible. 

Requested-Access 

Specify one or more requested-access masks in the l-byte FAC field of 


the FAB. This mask determines the access that the opening program has 
while the file is open. If you specify no requested-access mask, 
find/get access is allowed (the OPEN operation uses the mask FBSGET). 


The symbols for requested-access masks are: 


FBSDEL Request find/get/delete access 
FBSGET Request find/get access 

FBSPUT Request put access 

FBSREA Request block read access 

FBSTRN Request find/get/truncate access 
FBSUPD Request find/get/update access 
FBSWRT Request block write access 


Note that FBSREA and FBSWRT override any record access requested. 


Access Sharing 


Specify the kinds of access that your program will share with other 


programs by setting an access-sharing mask in the l-byte SHR field of 
the FAB. The symbols for access-sharing masks are: 

FBSGET Share find/get access 

FBSNIL No access sharing 

FBSUPI Share any access (uSer-provided interlock) 

FBSWRI Share find/get/put/update/delete access 


The kinds of 


access sharing are: 


e Shared read access 


Your program is willing to allow other programs to read _ the 
file, but not to write it. 

e Shared write access 
Your program is willing to allow other programs to both’ read 


and write the file. Shared write access is not allowed for a 
sequential file unless the file has undefined record format 
and your program opens the file for block access; shared 
write access is also not allowed for a relative or indexed 
file that your program opens for block access. In such cases, 
RMS-11 automatically converts’ the shared write access 
specification to a shared read access specification 


internally. 
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e No shared access 


Your program is not willing to allow other programs to either 
read or write the file. RMS-11 does, however, allow other 
programs to read the file unless your program also requests 
some form of write access. 


e User~provided interlocking 


Your program and other cooperating programs define and enforce 
their own access interlocking; RMS-11 does not check access 
sharing. User-provided interlocking is allowed only for 
sequential disk files; otherwise, the FBSUPI mask is ignored 
(but other masks are honored). 


Deferred Writing 


If you want deferred buffer writing for the open file, set the FBSDFW 
mask in the l-word FOP field of the FAB; This means that RMS-11l does 
not necessarily write its buffers during a write-type operation 
(DELETE, PUT, or UPDATE), but instead writes buffers only when it 
needs them for other operations (or when your program executes’ the 
FLUSH operation for the stream). 


If you do not set the FBSDFW mask, the DELETE, PUT, and UPDATE 
operations write buffers to the file immediately. 


Note that record operations always use a form of deferred buffer 
writing for sequential files, and that block operations never use 
deferred buffer writing. Therefore you need only decide whether to 
use deferred writing for a record stream to a relative or indexed 
fi kes, 


File Locking 


If you want the file to remain unlocked even if it is closed 
abnormally, set the FBSDLK mask in the l-word FOP field of the FAB; 
if you do not set this mask, the operating system locks the file if it 
is closed abnormally. 


Magtape Beginning-of-File Positioning 


If you have requested some form of write access, and if you want a 
magtape file positioned to the beginning of the file when it is 
opened, set the FBSNEF mask in the l-word FOP field of the FAB; if 
you do not set this mask, and if you requested some form of write 
access, the magtape is positioned to the end-of-file when the file is 
opened. 


Rewinding Magtape Before Open 


If you want a magtape rewound before a magtape file is opened, set the 
FBSRWO mask in the 1l-word FOP field of the FAB; if you do not set 
this mask, the OPEN operation searches only from the current magtape 
position to the end of the magtape. 
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Rewinding Magtape on Close 


If you want the magtape rewound when the opened file is closed, set 
the FBSRWC mask in the l-word FOP field of the FAB. If you do not set 
this mask, the magtape will not be rewound on close unless you set the 
FBSRWC mask for the CLOSE operation. Note, however, that if you set 
the FBSRWC mask for the OPEN operation, the magtape will be rewound 
even if you do not set the FBSRWC mask for the CLOSE operation. 


RETURNED VALUES 


Internal File Identifier 


The OPEN operation writes an internal file identifier in the 1-word 
IFI field of the FAB. (The CLOSE operation clears the internal file 
identifier.) 


The CLOSE, CONNECT, DISPLAY, and EXTEND operations read the internal 
file identifier; do not alter the IFI field while the file is open. 


Device Characteristics 


The OPEN operation returns device characteristics as masks in the 
l-byte DEV field of the FAB. The device characteristics are: 


e Printer or terminal (indicated by the set FBSCCL mask in the 
l-byte DEV field of the FAB and the set FBSREC mask in the 
l-byte DEV field of the FAB; for a terminal, the FBSTRM mask 
in the 1l-byte DEV field of the FAB is also set); RMS-11 
treats a printer or terminal as a unit-record device. 


e Disk, DECtape, or DECTAPE II (indicated by the set FBSMDI mask 
in the 1l-byte DEV field of the FAB); RMS-1l treats a disk, 
DECtape, or DECTAPE II as a disk device. 


@e Unit-record device (indicated by the set FBSREC mask in the 
l-byte DEV field of the FAB). 


@ Non-ANSI magtape or cassette tape (indicated by the set FBSSDI 
mask in the 1-byte DEV field of the FAB and the set FBSREC 
mask in the l-byte DEV field of the FAB); RMS-11l treats a 
non-ANSI magtape or a cassette tape as a unit-record device. 


@e ANSI-format magtape (indicated by the set FBSSQD mask in the 
l-byte DEV field of the FAB). 


Device, Directory, and File Identifiers 


If you supply a NAM block, the OPEN operation writes a device 
identifier in the 2-word DVI field of the NAM block, a directory 
identifier in the 3-word DID field of the NAM block (unless' directory 
processing was bypassed due to use of the file identifier on input), 
and a file identifier in the 3-word FID field of the NAM block. 


Expanded String 
If you specify a buffer for the expanded string for the file (ESA and 
ESS fields in the NAM block), the OPEN operation writes the expanded 


string for the opened file in this buffer, and writes the length (in 
bytes) of the string in the l-byte ESL field of the NAM block. 
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File Allocation, Bucket Size, and Contiguity 


The OPEN operation writes the file allocation size (in blocks) in the 
2-word ALQ field of the FAB, and the file bucket size or largest area 
bucket size (in blocks) in the 1l-byte BKS field of the FAB. If the 
file is contiguous, the OPEN operation sets the FBSCTG mask in the 
l-word FOP field of the FAB. 


Extension size 


The OPEN operation writes the current default extension size for the 
open file in the l-word DEQ field of the FAB. 


File Organization 


The OPEN operation writes the file organization code in the 1l-byte ORG 
field of the FAB. The symbols for file organization codes are: 


FBSIDX Indexed file organization 
FBSREL Relative file organization 
FBSSEQ Sequential file organization 


Record Format 


The OPEN operation writes the record format code in the I1l-byte RFM 
field of the FAB. The symbols for record format codes are: 


FBSFIX Fixed-length record format 
FBSSTM Stream record format 

FBSUDF Undefined record format 
FBSVAR Variable-length record format 
FBSVFC VFC record format 


If the record format is VFC, the OPEN operation writes the size (in 
bytes) of the VFC header field in the l-byte FSZ field of the FAB; 
otherwise it writes 0 in the FSZ field. 


Blocked Records (Sequential Disk File) 


If the file was created specifying blocked records, the OPEN operation 
sets the FBSBLK mask in the l-byte RAT field of the FAB. (The OPEN 
operation sets the mask if it was set when the file was created, even 
if the file is not a sequential file; preservation of this mask 
allows you to copy a sequential file to a file of a different 
organization and back without losing the blocked-record 
characteristic.) 


Record-Output Handling 


The OPEN operation writes the record-output mask in the 1-byte RAT 
field of the FAB. The symbols for record-output masks are: 


FBSCR Add CRLF to print record (LF-record-CR) 


FBSFTN FORTRAN-Style carriage-control character in record 
FBSPRN VFC print record handling 
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Record Size 


The OPEN operation writes the maximum permitted record size (in bytes) 
in the l-word MRS field of the FAB. 


Maximum Record Number 


If the file is a relative file (FBSREL in the ORG field), the OPEN 
operation writes the maximum record number in the 2-word MRN field of 
the FAB (unless you are opening the file for block access). 


Magtape Block Size 


For a magtape file, the OPEN operation writes the block size (in 
characters) in the l-word BLS field of the FAB. 


Longest Record Length 


The OPEN operation writes the length of the longest record in the file 
in the l-word LRL field of the FAB; this value is meaningful only for 
sequential files. 


Area Descriptions 


For each ALL block that you supply, the OPEN operation writes a 
description in its fields of the corresponding area of the file 
(unless you are opening the file for block access). Area 0 is 
described in the ALL block containing 0 in its AID field, area 1 is 
described in the ALL block containing 1 in its AID field, and_ so 
forth. 


The OPEN operation writes three sizes for a file area: the size (in 
blocks) of the unused portion of the area in the 2-word ALQ field of 
the ALL block, the default area extension size (in blocks) in the 
l-word DEQ field of the ALL block, and the area bucket size (in 
blocks) in the l-byte BKZ field of the ALL block. (If you are opening 
the file for block access, only the ALL block for area 0 is written, 
and the ALL block contains the current file allocation size, default 
file extension size, and file bucket size.) 


The OPEN operation clears the 1l-byte ALN field of the ALL block and 
the XBSHRD mask in the l-byte AOP field of the ALL block. If you are 
opening a sequential or relative file for any access, or an _ indexed 
file for block access, the OPEN operation sets the XBSCTG mask in the 
l-byte AOP field of the ALL block if the file is contiguous; 
otherwise it clears the entire l-byte AOP field of the ALL block. 


Key Descriptions 


For each KEY block that you supply, the OPEN operation writes a 
description in its fields of the corresponding index of the file. 
(The OPEN operation does not write in KEY blocks if you are opening 
the file for block access.) 


The primary index is described in the KEY block containing 0 in its 
REF field, the first alternate index is described in the KEY block 
containing 1 in its REF field, and so forth. 
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The OPEN operation writes the key data type code in the 1l-byte DTP 
field of the KEY block. The symbols for key data type codes are: 


XBSBN2 16-bit unsigned integer 
XBSBN4 32-bit unsigned integer 
XBSIN2 15-bit signed integer 
XBSIN4 31-bit signed integer 
XBSPAC Packed decimal number 
XBSSTG String 


The OPEN operation writes the sizes of key segments in the 8-byte SIZ 
field of the KEY block. The size (in bytes) of the first key segment 
is in the first byte of the SIZ field, the size of the second segment 
is in the second byte of the SIZ field, and so forth. If the key has 
fewer than eight segments, the first byte containing 0 establishes the 
number of key segments. 


The OPEN operation writes the positions of key segments in the 8-word 
POS field of the KEY block. The position (leftmost position is 0) of 
the first key segment is in the first word of the POS field, the 
position of the second segment is in the second word of the POS field, 
and so forth. If the key has fewer than eight segments, the remaining 
words of the POS field contain unpredictable values. 


The OPEN operation writes a key flags mask in the l-byte FLG field of 
the KEY block. The symbols for key flags masks are: 


XBSCHG Record key changes allowed on update 
XBSDUP Duplicate record keys allowed 
XBSINI No entries yet made in index 
XBSNUL Null record keys not indexed 


The OPEN operation writes the null-key character in the 1l-byte NUL 
field of the KEY block; this character is meaningful only if the 
XBSNUL mask in the FLG field is set and if the key is a string key 
(XBSSTG in the DTP field). 


The OPEN operation writes area numbers for the index: the area for 
the data level in the l-byte DAN field of the KEY block, the area for 
the lowest index level in the l-byte LAN field of the KEY block, and 
the area for higher index levels in the l-byte IAN field of the KEY 
block. 


The OPEN operation writes bucket fill numbers’ for the index areas: 
the fill number for the data area in the l-word DFL field of the KEY 
block, and the fill number for the index areas in the l-word IFL field 
of the KEY block. 


The OPEN operation writes bucket sizes for index areas: the data area 
bucket size (in blocks) in the l-byte DBS field of the KEY block, and 
the index area bucket size (in blocks) in the l-byte IBS field of the 
KEY block. 


The OPEN operation writes virtual block numbers for the index areas: 
the virtual block number for the first data bucket in the 2-word DVB 
field of the KEY block, and the virtual block number of the root index 
bucket in the 2-word RVB field of the KEY block. 


The OPEN operation writes the number of levels in the index (not 
including the data level) in the l-byte LVL field of the KEY block. 


The OPEN operation writes the minimum size (in bytes) of a record that 
contains the key for the index in the l-word MRL field of the KEY 
block. 
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The OPEN operation writes key segment information for the index: the 
number of key segments in the l-byte NSG field of the KEY block, and 
the total key size (sum of segments, in bytes) in the l-byte TKS field 
of the KEY block. 


File Owner and Protection (Disk File) 


If the file is a disk file, and if you supply a PRO block, the OPEN 
operation writes the project (or group) portion of the file owner code 
in the l-word PRJ field of the PRO block, the programmer (or member) 
portion of the file owner code in the l-word PRG field of the PRO 
block, and the file protection code in the l-word PRO field of the PRO 
block. 


File Dates 


If you supply a DAT block for a disk file, the OPEN operation writes 
four values in its fields: the creation date in the 4-word CDT field 
of the DAT block, the expiration date in the 4-word EDT field of the 
DAT block, the revision date in the 4-word RDT field of the DAT block, 
and the revision number (number of times the file has been opened _ for 
write access and then closed) in the l-word RVN field of the DAT 
block. 


File Summary Information 


If you supply a SUM block and are opening an indexed file, the OPEN 
operation writes three values in its fields: the number of file areas 
in the l-byte NOA field of the SUM block, the number of file indexes 
in the 1-byte NOK field of the SUM block, and the prologue version 
number (for a relative or indexed file) in the l-word PVN field of the 
SUM block. (If you are opening the file for block access, the OPEN 
operation returns the number of areas and the number of keys as 0, and 
does not return the prologue version number.) 


File Specification Characteristics 


The OPEN operation sets masks in the l-word FNB field of the NAM block 
to show which file specification elements were present in the file 
string and default string. These masks and their meanings are: 


NBSNOD Node in file string or default string 

NBSDEV Device in file string or default string 

NBSDIR Directory in file string or default string 

NBSQUO Quoted string in file string or default string 
NBSNAM File name in file string or default string 

NBSTYP File type in file string or default string 

NBSVER File version in file string or default string 
NBSWDI Wildcard directory in file string or default string 
NBSWNA Wildcard file name in file string or default string 
NBSWTY Wildcard file type in file string or default string 
NBSWVE Wildcard file version in file string or default string 


Wildcard Context Information 


If you cleared the FBSFID mask, the OPEN operation clears the NBSWCH 
mask in the l-word FNB field of the NAM block and the l-byte RSL field 
of the NAM block; this shows that no wildcard context information 
exists after the operation and that no resultant string was returned. 
If you set the FBSFID mask, the OPEN operation does not alter the 
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NBSWCH mask, 


field. 


and 


Completion Status and Value 


The OPEN operation returns completion status in the l-word STS 
of the 
the FAB. 


(if the NBSWCH mask is set) does not alter the RSL 


field 


FAB and returns a completion value in the l-word STV field of 
Appendix A lists completion status symbols and values. 


CHECKLISTS 


Table 5-37 lists control block fields 
Table 


operation. 
the OPEN operation. 


Block Field 


ALL 
ALL 
DAT 
FAB 
FAB 
FAB 
FAB 
FAB 
FAB 


FAB 
FAB 
FAB 


FAB 
FAB 
FAB 
FAB 


AID 
NXT 
NXT 
BPA 
BPS 
DEQ 
DNA 
DNS 
FAC 


FNA 
FNS 
FOP 


LCH 
NAM 
RTV 
SHR 


that are input to the OPEN 


5-38 lists control block fields that are output by 


Table 5-37: OPEN Input Fields 


Description 


Area number 

Next XAB address 
Next XAB address 
Private buffer pool address 

Private buffer pool size (bytes) 

While-open file default extension size (blocks) 
Default string address 

Default string size (bytes) 

Requested access 


FBSDEL 
FBSGET 
FBSPUT 
FBSREA 
FBSTRN 
FBSUPD 
EFBSWRT 


Request 
Request 
Request 
Request 
Request 
Request 
Request 


mask 


find/get/delete access 
find/get access 

put access 

block read access 
find/get/truncate access 
find/get/update access 
block write access 


File string address 
File string size (bytes) 
File processing option mask 


FBSDFW 
FBSDLK 
FBSFID 
FBSNEF 
FBS RWC 
FBSRWO 


Defer writing 


No file 


locking on abnormal close 


Use information in NAM block 

No end-of-file magtape positioning 
Rewind magtape after closing file 

Rewind magtape before searching for file 


Logical channel number 


NAM block address 


Retrieval pointer count 
Shared access mask 


FBSGET 
FBSNIL 
FBSUPI 
FBSWRI 


Share find/get access 

No access sharing 

Share any access (user-provided interlock) 
Share find/get/put/update/delete access 
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Block 


FAB 
KEY 
KEY 
KEY 
NAM 
NAM 
NAM 
NAM 
NAM 
NAM 


PRO 
SUM 


Field 


XAB 
KNM 
NXT 
REF 
DID 
DVI 
ESA 
ESS 
FID 
FNB 


NXT 
NXT 


Block Field 


ALL 
ALL 
ALL 


ALL 
ALL 
DAT 
DAT 
DAT 
DAT 
FAB 
FAB 
FAB 
FAB 
FAB 


FAB 


FAB 
FAB 
FAB 


ALN 
ALQ 
AOP 


BKZ 
DEQ 
CDT 
EDT 
RDT 
RVN 
ALQ 
BKS 
BLS 
DEQ 
DEV 


FOP 


FSZ 
LEX 
LRL 
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Table 5-37 (Cont.): OPEN Input Fields 


Description 


XAB address 

Key name buffer address 

Next XAB address 

Index reference number 

Directory identifier 

Device identifier 

Expanded string buffer address 
Expanded string buffer size (bytes) 


File 
File 


identifier 
specification mask 


NBSWCH Wildcard context established 


Next 
Next 


Area 


XAB address 


Table 5-38: OPEN Output Fields 


alignment mask 


Unused area allocation size (blocks) 


Area 


option mask 


XBSCTG Contiguous area 
XBSHRD Hard area location (cleared) 


Area 
Area 
File 
File 
File 
File 


bucket size (blocks) 

default extension size (blocks) 
creation date 

expiration date 

revision date 

revision number 


Current file allocation (blocks) 


File 


bucket size (blocks) 


Magtape block size (characters) 


Current file default extension size 


Device characteristic mask 


FBSCCL Carriage-control device 
FBSMDI Multidirectory device 
FBSREC Record-oriented device 
FBSSDI Single-directory device 
FBSSQD Sequential device 
FBSTRM Terminal device 


File 


processing option mask 


FBSCTG Contiguous file 


SOPEN MACRO 


XAB address 


Description 


(blocks) 


Fixed control area size for VFC records (bytes) 
Internal file identifier 
Longest record length 
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Table 5-38 (Cont.): OPEN Output Fields 


Block Field Description 


FAB MRN Maximum record number 
FAB MRS Maximum record size (bytes) 
FAB ORG File organization code 


FBSSEQ Sequential file organization 
FBSREL Relative file organization 
FBSIDX Indexed file organization 


FAB RAT Record handling mask 
FBSBLK Blocked records 
FBSCR Add CRLF to print record (LF-record-CR) 
FBSEFTN FORTRAN-Style carriage-control character in 
record 


FBSPRN VFC print record handling 
FAB REM Record format code 


FBSUDF Undefined record format 
FBSFIX Fixed-length record format 
FBSVAR Variable-length record format 
FBSVEFC VFC record format 

FBSSTM Stream record format 


FAB STS Completion status code 

FAB STV Completion status value 

KEY DAN Data area number 

KEY DBS Data area bucket size (blocks) 
KEY DFL Data bucket fill factor 

KEY DTP Key data type code 


XBSBN2 16-bit unsigned integer 
XBSBN4 32-bit unsigned integer 
XBSIN2 15-bit signed integer 
XBSIN4 31-bit signed integer 
XBS PAC Packed decimal number 
XBSSTG String 


KEY DVB First data bucket virtual block number 
KEY FLG Index option mask 


XBSCHG Record key changes allowed on update 
XBSDUP Duplicate record keys allowed 
XBSINI No entries yet made in index 
XBSNUL Null record keys not indexed 


KEY IAN Higher level index area number 

KEY IBS Index area bucket size (blocks) 

KEY IFL Index bucket fill factor 

KEY LAN Lowest index level area number 

KEY LVL Number of index levels (not including data level) 
KEY MRL Minimum length of record containing key (bytes) 
KEY NSG Key segment count 

KEY NUL Null key character 

KEY POS Key segment positions 
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Table 5-38 (Cont.): OPEN Output Fields 


Block Field Description 


KEY RVB Root index bucket virtual block number 

KEY SIZ Key segment sizes (bytes) 

KEY TKS Total key size (sum of key segment sizes) (bytes) 
NAM DID Directory identifier 

NAM DVI Device identifier 

NAM ESL Expanded string length (bytes) 

NAM FID File identifier 

NAM FNB File specification mask 


NBSNOD Node in file string or default string 

NBSDEV Device in file string or default string 

NBSDIR Directory in file string or default string 

NBSQUO Quoted string in file string or default 
string 

NBSNAM File name in file string or default string 

NBSTYP File type in file string or default string 

NBSVER File version in file string or default 
string 

NBSWDI Wildcard directory in file string OF 
default string 

NBSWNA Wildcard file name in file string or 
default string 

NBSWTY Wildcard file type in file string or 
default string 

NBSWVE Wildcard file version in file string or 
default string 

NBSWCH Wildcard context established 


NAM RSL Resultant string length (bytes) (cleared) 

PRO PRG Programmer or member portion of file owner code 
PRO PRJ Project or group portion of file owner code 

PRO PRO File protection code 

SUM NOA Number of areas 

SUM NOK Number of indexes 

SUM PVN Prologue version number 
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5.20 SPARSE MACRO 


The $PARSE macro calls the PARSE operation routine to analyze ae file 
specification. 


FORMAT 
The format for the SPARSE is: 
SPARSE fabaddr[,[erraddr] [,sucaddr] } 


where fabaddr is the address of the FAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 
You must supply a FAB for the PARSE operation. 


If you supply a NAM block for the PARSE operation, the operation 
routine writes file information in its fields. This information is 
Suitable as input to subsequent wildcard SEARCH operations. 


To supply a NAM block for the PARSE operation, specify the address of 
the NAM block in the l-word NAM field of the FAB. 


To supply XABs (ALL, DAT, KEY, PRO, and SUM _ blocks) for the PARSE 
Operation, specify the address of the first XAB in the l-word XAB 
field of the FAB; specify the address of the next XAB (if any) in the 
l-word NXT field of each XAB; specify 0 in the NXT field of the last 
XAB. 


All KEY blocks must be together in the chain of XABS, and must be in 
ascending order (by the index reference number in the l-byte REF field 
of the KEY block); the index reference numbers need not be 
consecutive. 


All ALL blocks must be together in the chain of XABS, and must be in 
ascending order (by the area identifier in the 1-byte AID field of the 
ALL block); the area identifiers need not be consecutive. 


Multiple DAT, PRO, or SUM XABs are illegal. 


OPTIONS 


File Specification 


The PARSE operation constructs the full file specification from _ the 
file string, the default string (which contributes only elements not 
present in the file string), and RMS-1l defaults (which contribute 
elements not present in either the file string or the default string). 
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RMS-11 defaults are: 


@e Device -- The device to which the specified logical channel is 
assigned, or SY: if the specified logical channel is not 
assigned to any device. 


@ Directory -- The current directory for the task. 
e Name, type, version -- Defaulted to null. 


Specify the address of the file string in the l-word FNA field of the 
FAB. Specify the size (in bytes) of the file string in the l-byte FNS 
field of the FAB; if you specify 0 in the FNS field, the PARSE 
Operation uses no file string. 


Specify the address of the default string in the l-word DNA field of 
the FAB. Specify the size (in bytes) of the default string in the 
l-byte DNS field of the FAB; if you specify 0 in the DNS field, the 
PARSE operation uses no default string. 


Expanded String Buffer 


If you want the PARSE operation to return the expanded string for’ the 
file, provide a buffer for the string. If you want subsequent 
wildcard SEARCH operations to use the results of the PARSE operation, 
you must provide an expanded string buffer. 


Specify the address of the expanded string buffer in the 1l-word ESA 
field of the NAM block. Specify the size (in bytes) of the expanded 
string buffer in the l-byte ESS field of the NAM _ block; if you 
specify 0 in the ESS field, the PARSE operation does not return the 
expanded string. 


Private Buffer Pool 


If you want the PARSE operation to use a private buffer pool instead 
of the central buffer pool, specify the address of the (word-aligned) 
private buffer pool in the l-word BPA field of the FAB, and its’ size 
(in bytes) in the l-word BPS field of the FAB; this size must be a 
multiple of 4, 


If you specify 0 in either the BPA field or the BPS field, the PARSE 
Operation uses the central buffer pool. 


Logical Channel 


Specify the logical channel for the PARSE operation in the 1l-byte LCH 
field of the FAB. The logical channel number must not be the same as 
the logical channel number for any already-open file, and must not be 
0. 


RETURNED VALUES 


Wildcard Initialization 


If you supplied a NAM block to be initialized for wildcard SEARCH 
operations, the PARSE operation clears several fields: the 3-word DID 
field of the NAM block, the 1l-byte RSL field of the NAM block, the 
l-word WCC field of the NAM block, and the l-word WDI field of the NAM 
block. These cleared fields are part of the initialization for 
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subsequent wildcard SEARCH operations. 


The PARSE operation writes a match-pattern (for subsequent wildcard 
SEARCH operations) in the expanded string buffer, and writes the 
length (in bytes) of the expanded string in the l-byte ESL field of 
the NAM block. 


The PARSE operation sets the NBSWCH mask in the l-word FNB field of 
the NAM block, showing that wildcard information in the NAM block is 
initialized. 


Device Characteristics 


The PARSE operation returns device characteristics as masks in the 
l-byte DEV field of the FAB. The device characteristics are: 


@e Printer or terminal (indicated by the set FBSCCL mask in the 
l-byte DEV field of the FAB and the set FBSREC mask in the 
l-byte DEV field of the FAB; for a terminal, the FBSTRM mask 
in the l-byte DEV field of the FAB is also set); RMS-11 
treats a printer or terminal as a unit-record device. 


e Disk, DECtape, or DECTAPE II (indicated by the set FBSMDI mask 
in the 1l-byte DEV field of the FAB); RMS-11l treats a disk, 
DECtape, or DECTAPE II as a disk device. 


@® Unit-record device (indicated by the set FBSREC mask in the 
l-byte DEV field of the FAB). 


@ Non-ANSI magtape or cassette tape (indicated by the set FBSSDI 
mask in the 1-byte DEV field of the FAB and the set FBSREC 
mask in the l-byte DEV field of the FAB); RMS-ll treats a 
non-ANSI magtape or a cassette tape as a unit-record device. 


e ANSI-format magtape (indicated by the set FBSSQD mask in the 
l-byte DEV field of the FAB). 


Device Identifier 


If you supply a NAM block, the PARSE operation writes a device 
identifier in the 2-word DVI field of the NAM block. 


File Specification Characteristics 


The PARSE operation sets masks in the l-word FNB field of the NAM 
block to show which file specification elements were present in the 
file string and default string. These masks and their meanings are: 


NBSNOD Node in file string or default string 

NBSDEV Device in file string or default string 

NBSDIR Directory in file string or default string 

NBSQUO Quoted string in file string or default string 
NBSNAM File name in file string or default string 

NBSTYP File type in file string or default string 

NBSVER File version in file string or default string 
NBSWDI Wildcard directory in file string or default string 
NBSWNA Wildcard file name in file string or default string 
NBSWTY Wildcard file type in file string or default string 
NBSWVE Wildcard file version in file string or default string 
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Expanded String 

If you supply a NAM block, and if the input file specification string 
does not contain wildcard characters, the PARSE operation writes the 
expanded string in the expanded string buffer; this string is a fully 
qualified file specification except that the file version number (if 
any) from the input file specification is unchanged. 

Completion Status and Value 

The PARSE operation returns completion status in the l-word STS field 
of the FAB and returns a completion value in the l-word STV field of 
the FAB. Appendix A lists completion status symbols and values. 
CHECKLISTS 

Table 5-39 lists control block fields that are input to the PARSE 
operation. Table 5-40 lists control block fields that are output by 
the PARSE operation. 


Table 5-39: PARSE Input Fields 


Block Field Description 


ALL NXT Next XAB address 

DAT NXT Next XAB address 

FAB BPA Private buffer pool address 

FAB BPS Private buffer pool size (bytes) 
FAB DNA Default string address 

FAB DNS Default string size (bytes) 

FAB FNA File string address 

FAB FNS File string size (bytes) 

FAB LCH Logical channel number 

FAB NAM NAM block address 

KEY NXT Next XAB address 

NAM ESA Expanded string buffer address 
NAM ESS Expanded string buffer size (bytes) 
PRO NXT Next XAB address 

SUM NXT Next XAB address 


Table 5-40: PARSE Output Fields 
Block Field Description 
FAB DEV Device characteristic mask 


FBSCCL Carriage-control device 
FBSMDI Multidirectory device 
FBSREC Record-oriented device 
FBSSDI Single-directory device 
FBSSQD Sequential device 
FBSTRM Terminal device 


FAB STS Completion status code 

FAB STV Completion status value 

NAM DID Directory identifier (cleared) 
NAM DVI Device identifier 

NAM ESL Expanded string length (bytes) 
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Table 5-40 (Cont.): PARSE Output Fields 


Block Field Description 


NAM FNB File specification mask 
NBSNOD Node in file string or default string 
NBSDEV Device in file string or default string 
NBSDIR Directory in file string or default string 
NBSQUO Quoted string in file string or default 
string 
NBSNAM File name in file string or default string 
NBSTYP File type in file string or default string 
NBSVER File version in file string or default 
string 
NBSWCH Wildcard context established 
NBSWDI Wildcard directory in file string or 
default string 
NBSWNA Wildcard file name in file string or 
default string 
NBSWTY Wildcard file type in file string or 
default string 
NBSWVE Wildcard file version in file string or 
default string 
NAM RSL Resultant string length (bytes) (cleared) 
NAM wcc Wildcard context (cleared) 
NAM WDI Wildcard directory context (cleared) 
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5.21 $PUT MACRO (SEQUENTIAL ACCESS) 


The S$PUT macro calls the PUT operation routine to transfer a_ record 
from a user buffer to an I/O buffer and to a file. 


The target of a sequential-access PUT operation depends on the file 
organization: 


e For a sequential file, the target of a sequential-access PUT 
operation is the end-of-file, and the next-record context must 
be the end-of-file. 


e For a relative file, the target of a sequential-access PUT 
operation is the next cell (as determined by the next-record 
context or by the context of an _ immediately preceding 
sequential access PUT operation). 

@e For an indexed file, a sequential-access PUT operation has no 
target; the PUT operation inserts the record and updates 
indexes. If the immediately preceding operation was also a 
sequential access PUT operation, the primary key value in your 
record must be greater than or equal to the primary key value 
of the preceding record. 

FORMAT 
The format for the SPUT is: 
SPUT rabaddr[, [erraddr]) [,sucaddr] ] 
where rabaddr is the address of the RAB for the operation; erraddr is 


the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the PUT operation. 
OPTIONS 


Internal Stream Identifier 

The PUT operation reads the internal stream identifier from the l-word 
ISI field of the RAB. 

Asynchronous Operation 

If you want to execute the PUT operation asynchronously, set the 
RBSASY mask in the I1l-word ROP field of the RAB; if you do not set 
this mask, the PUT operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


Sequential Access 


Specify the RBSSEQ code in the l-byte RAC field of the RAB. 
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Record 


Specify the address of the record to be transferred in the l-word RBF 
field of the RAB, and the size (in bytes) of the record in the l-word 
RSZ field of the RAB. 


If the record is in VFC format, specify the address of the 
fixed-length portion of the record in the l-word RHB field of the RAB. 
If you specify 0 in this field, the record header will be null-filled. 


Locate Mode 


For a sequential file, if you want the PUT operation to use _ locate 
mode, specify the address of the user buffer in the l-word UBF field 
of the RAB, specify the maximum size of the record for the next PUT 
operation in the l-word USZ field of the RAB, and set the RBSLOC mask 
in the l-word ROP field of the RAB. 


The PUT operation returns (in the RBF field) the address of a location 
where your program can build the next record for output. The maximum 
next record size that you specify in the USZ field determines whether 
the next record can fit into an I/0 buffer. 


Bucket Fill Number Honoring 


If you want the PUT operation to honor bucket fill numbers’ for the 
file and its areas, set the RBSLOA mask in the l-word ROP field of the 
RAB. If you do not set this mask, the PUT operation fills buckets 
without regard to bucket fill numbers. 


Update Existing Record (Relative File) 


If you want to transfer the record to a cell in a relative file even 
if the cell contains a record, set the RBSUIF mask in the l-word ROP 
field of the RAB. If you do not set this mask, and if the cell 
already contains a record, the PUT operation returns an error 
completion and does not transfer the record. 


Mass Insertion (Indexed File) 

For an indexed file, using mass-insertion mode for a series of PUT 
operations speeds up the insertion of a series of records. To use 
mass-insertion mode for a series of records, set the RBSMAS mask _ in 
the l-word ROP field of the RAB for each PUT operation in the series. 


STREAM CONTEXT 


The current-record and next-record contexts after a sequential access 
PUT operation are undefined. 
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RETURNED VALUES 


Next Record Buffer 


If you specified locate mode for the PUT operation, the PUT operation 
returns the address of a location where your program can build the 
next record for output in the l-word RBF field of the RAB. This 
address gives a location in the I/0 buffer (if there is room for 
another record there), or the location of your user buffer (if not). 


RRN 

For a relative file or for a sequential disk file with fixed-length 
records, a sequential-access PUT operation returns the relative record 
number (RRN) for the inserted record in the 2-word BKT field of the 
RAB. 

RFA 

The PUT operation returns the record file address (RFA) for the 
inserted record in the 3-word RFA field of the RAB. 

Completion Status and Value 

The PUT operation returns completion status in the l-word STS field of 
the RAB and returns a completion value in the l-word STV field of the 
RAB. Appendix A lists completion status symbols and values. 
CHECKLISTS 

Table 5-41 lists control block fields that are input to the PUT 


operation. Table 5-42 lists control block fields that are output by 
the PUT operation, 


Table 5-41: PUT (Sequential Access) Input Fields 


Block Field Description 


RAB ISI Internal stream identifier 
RAB RAC Record access code 


RBSSEQ Sequential access 


RAB RBF Record buffer address 
RAB RHB VFC control buffer address 
RAB ROP Record processing option mask 


RBSASY Asynchronous operation 
RBSLOA Honor bucket fill numbers 
RBSLOC Locate mode 

RBSMAS Mass insert 

RBSUIF Update if record exists 


RAB RSZ Record size (bytes) 
RAB UBF User buffer address 
RAB USZ User buffer size (bytes) 
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Table 5-42: PUT (Sequential Access) Output Fields 


Block Field Description 


RAB BKT Relative record number (RRN) 
RAB RFA Record file address 

RAB RBF Record buffer address 

RAB STS Completion status code 

RAB STV Completion status value 
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5.22 SPUT MACRO (KEY ACCESS) 
The $PUT macro calls the PUT operation routine to transfer a_ record 
from a user buffer to an I/O buffer and to a sequential disk file 


(with fixed-length records), a relative file, or an indexed file. 


The target of a key-access PUT operation depends on the file 
organization: 


@e For a sequential disk file (with fixed-length records) or a 
relative file, the key is a relative record number (RRN), and 
the target of a key-access PUT operation is the cell specified 
by the RRN. 

e For an indexed file, a key-access PUT operation has no target; 
the PUT operation inserts the record and updates indexes. 

FORMAT 
The format for the SPUT is: 

SPUT rabaddr[,[erraddr] [,sucaddr] ] 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the PUT operation. 


OPTIONS 


Internal Stream Identifier 

The PUT operation reads the internal stream identifier from the l-word 
ISI field of the RAB. 

Asynchronous Operation 

If you want to execute the PUT operation asynchronously, set the 
RBSASY mask in the 1-word ROP field of the RAB; if you do not set 
this mask, the PUT operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


Key Access 


Specify the RBSKEY code in the l-byte RAC field of the RAB. 


Record 


Specify the address of the record to be transferred in the l-word RBF 
field of the RAB, and the size (in bytes) of the record in the l-word 
RSZ field of the RAB. 
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If the record is in VFC format, specify the address of the 
fixed-length portion of the record in the l-word RHB field of the RAB. 
If you specify 0 in this field, the record header will be null-filled. 


Record Buffer 


Specify a record buffer for the PUT operation; specify the address of 
the record buffer in the l-word UBF field of the RAB; specify the 
size (in bytes) of the record buffer in the l-word USZ field of the 
RAB. 


Note that the value in the UBF field will be used (copied to the  RBF 
field) only if you specify locate mode. A request for locate mode is 
otherwise ignored for a key access PUT operation. 


RRN 


For a relative file or for a sequential disk file with fixed-length 
records, specify a 4-byte relative record number (RRN) in the 1l-word 
KBF field of the RAB, and specify 0 or 4 in the l-byte KSZ field of 
the RAB. 


Bucket Fill Number Honoring 

If you want the PUT operation to honor bucket fill numbers’ for. the 
file and its areas, set the RBSLOA mask in the l-word ROP field of the 
RAB. If you do not set this mask, the PUT operation fills buckets 
without regard to bucket fill numbers. 

Update Existing Record (Relative File) 

If you want to transfer the record to a cell ina relative file even 
if the cell contains a record, set the RBSUIF mask in the l-word ROP 
field of the RAB. If you do not set this mask, and if the cell 
already contains a record, the PUT operation returns an error 
completion and does not transfer the record. 

STREAM CONTEXT 

The current-record context after a key access PUT operation is 
undefined; the next-record context is unchanged. 


RETURNED VALUES 


RRN 

For a relative file or for a sequential disk file with fixed-length 
records, a key-access PUT operation returns the relative record number 
(RRN) for the inserted record in the 2-word BKT field of the RAB. 


RFA 


The PUT operation returns the record file address (RFA) for the 
inserted record in the 3-word RFA field of the RAB. 
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Completion Status and Value 
The PUT operation returns completion status in the l-word STS field of 
the RAB and returns a completion value in the l-word STV field of the 
RAB. Appendix A lists completion status symbols and values. 
CHECKLISTS 
Table 5-43 lists control block fields that are input to the PUT 
operation. Table 5-44 lists control block fields that are output by 
the PUT operation. 


Table 5-43: PUT (Key Access) Input Fields 


Block Field Description 


RAB ISI Internal stream identifier 
RAB KBF Key buffer address 

RAB KSZ Key size (bytes) 

RAB RAC Record access code 


RBSKEY Key access 


RAB RBF Record buffer address 
RAB RHB VFC control buffer address 
RAB ROP Record processing option mask 


RBSASY Asynchronous operation 
RBSLOA Honor bucket fill numbers 
RBSLOC Locate mode 

RBSUIF Update if record exists 


RAB RSZ Record size (bytes) 
RAB UBF User buffer address 
RAB USZ User buffer size (bytes) 


Table 5-44: PUT (Key Access) Output Fields 


Block Field Description 


RAB BKT Relative record number (RRN) 
RAB RBF Record buffer address 

RAB RFA Record file address 

RAB STS Completion status code 

RAB STV Completion status value 
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5.23 SREAD MACRO (SEQUENTIAL ACCESS) 
The SREAD macro calls the READ operation routine to transfer blocks 
from a file to an I/O buffer. The target of a sequential-access READ 
Operation is the readable block (and, for a multiblock READ operation, 
following blocks). 
FORMAT 
The format for the SREAD is: 

SREAD rabaddr[,[erraddr] [,sucaddr] ] 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the READ operation. 


OPTIONS 


Internal Stream Identifier 


The READ operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 


Block Specification 


For a sequential-access READ operation, specify 0 in the 2-word BRKT 
field of the RAB. 


User Buffer 


Specify the address of the user buffer in the l-word UBF field of the 
RAB, and specify the size (in bytes) of the user buffer in the l-word 
USZ field of the RAB. 


For a magtape file, the READ operation reads at most one magtape block 
into the buffer; for other files, the READ operation fills the buffer 
(unless it reached the end-of-file before the buffer is filled). 


Asynchronous Operation 


If you want to execute the READ operation asynchronously, set the 
RBSASY mask in the 1l-word ROP field of the RAB; if you do not set 
this mask, the READ operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


STREAM CONTEXT 
The readable-block context after a READ operation is the block 


following the last-read block; the writable-block context is the 
first-read block. 
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RETURNED VALUES 


Data Blocks 


The READ operation returns the address and length of the data _ read 
from the file. The value in the l-word RBF field of the RAB is the 
address of the data read; the value in the l-word RSZ field of the 
RAB is the length (in bytes) of the data read. 


The READ operation normally will not read beyond the logical 
end-of-file. For sequential files with undefined (UDF) record format, 
however, the READ operation will respect the logical end-of-file 
marker only if you have specified no write-sharing in the l-byte SHR 
field of the FAB. If you specify write-sharing, RMS-ll will ignore 
the logical end-of-file marker and will stop only at the physical 
end-of-file on the disk. 


Record File Address (RFA) 

The READ operation returns the virtual block number of the first-read 
block in the first two words of the 3-word RFA field of the RAB (it 
clears the third word). 

Completion Status and Value 

The READ operation returns completion status in the l-word STS field 


of the RAB and returns a completion value in the l-word STV field of 
the RAB. Appendix A lists completion status symbols and values. 


CHECKLISTS 


Table 5-45 lists control block fields that are input to the READ 
operation. Table 5-46 lists control block fields that are output by 
the READ operation. 


Table 5-45: READ (Sequential Access) Input Fields 


Block Field Description 


RAB BKT Virtual block number (VBN) 
RAB ISI Internal stream identifier 
RAB ROP Record processing option mask 


RBSASY Asynchronous operation 


RAB UBF User buffer address 
RAB USZ User buffer size (bytes) 


Table 5-46: READ (Sequential Access) Output Fields 


Block Field Description 


RAB RBF Record buffer address 

RAB RFA Virtual block number (2 words) 
RAB RSZ Record size (bytes) 

RAB STS Completion status code 

RAB STV Completion status value 
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5.24 SREAD MACRO (VBN ACCESS) 
The SREAD macro calls the READ operation routine to transfer blocks 
from a file to an I/O buffer. The target of a VBN-access READ 
operation is a specified block (and, for a multiblock READ operation, 
following blocks). 
FORMAT 
The format for the SREAD is: 

SREAD rabaddr[,[erraddr] [,sucaddr] } 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the READ operation. 


OPTIONS 


Internal Stream Identifier 


The READ operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 


Block Specification 


Specify the virtual block number of the first block to be read in the 
2-word BKT field of the RAB. 


User Buffer 


Specify the address of the user buffer in the l-word UBF field of the 
RAB, and specify the size (in bytes) of the user buffer in the l-word 
USZ field of the RAB. 


For a magtape file, the READ operation reads at most one magtape block 
into the buffer; for other files, the READ operation fills the buffer 
(unless it reached the end-of-file before the buffer is filled). 


Asynchronous Operation 


If you want to execute the READ operation asynchronously, set the 
RBSASY mask in the 1l-word ROP field of the RAB; if you do not set 
this mask, the READ operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


STREAM CONTEXT 
The readable-block context after a READ operation is the block 


following the last-read block; the writable-block context is the 
first-read block. 
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RETURNED VALUES 


Data Blocks 


The READ operation returns the address and length of the data _ read 
from the file. The value in the l-word RBF field of the RAB is the 
address of the data read; the value in the l-word RSZ field of the 
RAB is the length (in bytes) of the data read. 


The READ operation normally will not read beyond the logical 
end-of-file. For sequential files with undefined (UDF) record format, 
however, the READ operation will respect the logical end-of-file 
marker only if you have specified no write-sharing in the l-byte SHR 
field of the FAB. If you specify write-sharing, RMS-1l will ignore 
the logical end-of-file marker and will stop only at the physical 
end-of-file on the disk. 


Record File Address (RFA) 

The READ operation returns the virtual block number of the first-read 
block in the first two words of the 3-word RFA field of the RAB (it 
clears the third word). 

Completion Status and Value 

The READ operation returns completion status in the l-word STS field 


of the RAB and returns a completion value in the l-word STV field of 
the RAB. Appendix A lists completion status symbols and values. 


CHECKLISTS 


Table 5-47 lists control block fields that are input to the READ 
operation. Table 5-48 lists control block fields that are output by 
the READ operation. 


Table 5-47: READ (VBN Access) Input Fields 


Block Field Description 


RAB BKT Virtual block number (VBN) 
RAB ISI Internal stream identifier 
RAB ROP Record processing option mask 


RBSASY Asynchronous operation 


RAB UBF User buffer address 
RAB USZ User buffer size (bytes) 


Table 5-48: READ (VBN Access) Output Fields 


Block Field Description 


RAB RBF Record buffer address 

RAB RFA Virtual block number (2 words) 
RAB RSZ Record size (bytes) 

RAB STS Completion status code 

RAB STV Completion status value 
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5.25 $REMOVE MACRO 


The SREMOVE macro calls the REMOVE operation routine to remove’ the 
directory entry for a file. 


FORMAT 
The format for the SREMOVE is: 
SREMOVE fabaddr([,[erraddr] [,sucaddr] } 


where fabaddr is the address of the FAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 
You must supply a FAB for the REMOVE operation. 


If you supply a NAM block and specify remove by NAM block, the REMOVE 
operation reads NAM block fields to obtain identifiers for the target 
file. 


To supply a NAM block for the REMOVE operation, specify the address of 
the NAM block in the l-word NAM field of the FAB. 


To supply XABs (ALL, DAT, KEY, PRO, and SUM blocks) for the REMOVE 
operation, specify the address of the first XAB in the l-word XAB 
field of the FAB; specify the address of the next XAB (if any) in the 
l-word NXT field of each XAB; specify 0 in the NXT field of the last 
XAB. 


All KEY blocks must be together in the chain of XABS, and must be in 
ascending order (by the index reference number in the l-byte REF field 
of the KEY block); the index reference numbers need not be 
consecutive. 


All ALL blocks must be together in the chain of XABS, and must be in 
ascending order (by the area identifier in the l-byte AID field of the 
ALL block); the area identifiers need not be consecutive. 


Multiple DAT, PRO, or SUM XABs are illegal. 
OPTIONS 


File Specification (Nonwildcard REMOVE Operation) 


The REMOVE operation constructs the full file specification from the 
file string, the default string (which contributes only elements not 
present in the file string), and RMS-1l defaults (which contribute 
elements not present in either the file string or the default string). 
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RMS-11 defaults are: 


@ Device -- The device to which the specified logical channel is 
assigned, or SY: if the specified logical channel is not 
assigned to any device. 


@e Directory -- The current directory for the task. 
e Name, type, version -- Defaulted to null. 
The file string and the default string must not contain wildcards. 


Specify the address of the file string in the l-word FNA field of the 
FAB. Specify the size (in bytes) of the file string in the l-byte FNS 
field of the FAB; if you specify 0 in the FNS field, the REMOVE 
operation uses no file string. 


Specify the address of the default string in the l-word DNA field of 
the FAB. Specify the size (in bytes) of the default string in the 
l-byte DNS field of the FAB; if you specify 0 in the DNS field, the 
REMOVE operation uses no default string. 


If you set the FBSFID mask in the l-word FOP field of the FAB and 
supply a NAM block, the REMOVE operation reads the device identifier 
from the 2-word DVI field of the NAM block; if this value is nonzero, 
the specified device overrides the device in the merged string. 


In the same circumstance, the REMOVE operation reads the directory 
identifier from the 3-word DID field of the NAM block; if this value 
is nonzero, the specified directory overrides the directory in the 
merged string. 


Remove by Wildcard Specification 


You can use the REMOVE operation in a wildcarding program loop. (The 
NBSWCH mask in the l-word FNB field of the NAM block will already have 
been set by an earlier PARSE operation.) 


If you set the FBSFID mask in the l-word FOP field of the FAB, the 
file found by a previous SEARCH operation is removed without affecting 
fields that are used as context for subsequent SEARCH operations. 


If you clear the FBSFID mask in the l-word FOP field of the FAB, the 
REMOVE operation first performs an implicit SEARCH operation. (The 
input and output fields for the SEARCH operation are not described 
here and are not included in the checklists at the end of this 
section.) 


If the SEARCH operation finds a file that matches the wildcard file 
specification, the REMOVE operation removes its directory entry; if 
not, the REMOVE operation does not remove a directory entry, but 
instead passes control block data from the SEARCH operation (in 
particular, the ERSNMF completion status code and the cleared NBSWCH 
mask in the l-word FNB field of the NAM block). 
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Expanded String Buffer 


If you want the REMOVE operation to return the expanded string for the 
file whose directory entry was removed, provide a buffer for the 
string. Specify the address of the expanded string buffer in the 
l-word ESA field of the NAM block. Specify the size (in bytes) of the 
expanded string buffer in the l-byte ESS field of the NAM block; if 
you specify 0 in the ESS field, the REMOVE operation does not return 
the expanded string. 


Private Buffer Pool 


If you want the REMOVE operation to use a private buffer pool instead 
of the central buffer pool, specify the address of the (word-aligned) 
private buffer pool in the l-word BPA field of the FAB, and its’ size 
(in bytes) in the l-word BPS field of the FAB; this size must be a 
multiple of 4. 


If you specify 0 in either the BPA field or the BPS field, the REMOVE 
operation uses the central buffer pool. 


Logical Channel 


Specify the logical channel for the REMOVE operation in the 1l-byte LCH 
field of the FAB. The logical channel number must not be the same as 
the logical channel number for any already-open file, and must not be 
QO. 


RETURNED VALUES 


Device Characteristics 


The REMOVE operation returns device characteristics as masks in the 
l-byte DEV field of the FAB. The device characteristics are: 


e Printer or terminal (indicated by the set FBSCCL mask in the 
l-byte DEV field of the FAB and the set FBSREC mask in the 
l-byte DEV field of the FAB; for a terminal, the FBSTRM mask 
in the 1l-byte DEV field of the FAB is also set); RMS-11 
treats a printer or terminal as a unit-record device. 


e Disk, DECtape, or DECTAPE II (indicated by the set FBSMDI mask 
in the 1l-byte DEV field of the FAB); RMS-11 treats a disk, 
DECtape, or DECTAPE II as a disk device. 


@e Unit-record device (indicated by the set FBSREC mask in the 
l-byte DEV field of the FAB). 


@e Non-ANSI magtape or cassette tape (indicated by the set FBSSDI 
mask in the 1l-byte DEV field of the FAB and the set FBSREC 
mask in the l-byte DEV field of the FAB); RMS-ll treats a 
non-ANSI magtape or a cassette tape as a unit-record device. 


@ ANSI-format magtape (indicated by the set FBSSQD mask in the 
l-byte DEV field of the FAB). 
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Device, Directory, and File Identifiers 


If you supply a NAM block, the REMOVE operation writes a device 
identifier in the 2-word DVI field of the NAM block, a directory 
identifier in the 3-word DID field of the NAM block, and ae file 
identifier in the 3-word FID field of the NAM block. 


Expanded String 


If you specify a buffer for the expanded string for the file (ESA and 
ESS fields in the NAM block), the REMOVE operation writes the expanded 
string for the target file in this buffer, and writes the length (in 
bytes) of the string in the l-byte ESL field of the NAM block. 


File Specification Characteristics 


The REMOVE operation sets the masks in the l-word FNB field of the NAM 
block to show which file specification elements were present in the 
file string and default string. 


These masks and their meaning are: 


NBSNOD Node in file string or default string 

NBSDEV Device in file string or default string 

NBSDIR Directory in file string or default string 

NBSQUO Quoted string in file string or default string 
NBSNAM File name in file string or default string 

NBSTYP File type in file string or default string 

NBSVER File version in file string or default string 
NBSWDI Wildcard directory in file string or default string 
NBSWNA Wildcard file name in file string or default string 
NBSWTY Wildcard file type in file string or default string 
NBSWVE Wildcard file version in file string or default string 


Wildcarding 

The REMOVE operation clears the NBSWCH mask in the l-word FNB field of 
the NAM block; this shows that no wildcard context exists after the 
REMOVE operation. It also clears the l-byte RSL field of the NAM 
block to show that no resultant string was returned. 

Completion Status and Value 

The REMOVE operation returns completion status in the l-word STS field 
of the FAB and returns a completion value in the l-word STV field of 
the FAB. Appendix A lists completion status symbols and values. 
CHECKLISTS 

Table 5-49 lists control block fields that are input to the REMOVE 


operation. Table 5-50 lists control block fields that are output by 
the REMOVE operation. 
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Table 5-49: REMOVE Input Fields 


Block Field Description 


ALL NXT Next XAB address 

DAT NXT Next XAB address 

FAB BPA Private buffer pool address 

FAB BPS Private buffer pool size (bytes) 
FAB DNA Default string address 

FAB DNS Default string size (bytes) 

FAB FNA File string address 

FAB ENS File string size (bytes) 

FAB FOP File processing option mask 


FBSFID Use information in NAM block 


FAB LCH Logical channel number 

FAB NAM NAM block address 

KEY NXT Next XAB address 

NAM DID Directory identifier 

NAM DVI Device identifier 

NAM ESA Expanded string buffer address 

NAM ESS Expanded string buffer size (bytes) 
NAM FID File identifier 

NAM FNB File specification mask 


NBSWCH Wildcard context established 


PRO NXT Next XAB address 
SUM NXT Next XAB address 


Table 5-50: REMOVE Output Fields 


Block Field Description 


FAB DEV Device characteristic mask 


FBSCCL Carriage-control device 
FBSMDI Multidirectory device 
FBSREC Record-oriented device 
FBSSDI Single-directory device 
FBSSQD Sequential device 
FBSTRM Terminal device 


FAB STS Completion status code 

FAB STV Completion status value 

NAM DID Directory identifier 

NAM DVI Device identifier 

NAM ESL Expanded string length (bytes) 
NAM FID File identifier 


(Continued on next page) 
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Table 5-50 (Cont.): REMOVE Output Fields 


Block Field Description 


NAM FNB File specification mask 


NBSNOD Node in file string or default string 

NBSDEV Device in file string or default string 

NBSDIR Directory in file string or default string 

NBSQUO Quoted string in file string or default 
string 

NBSNAM File name in file string or default string 

NBSTYP File type in file string or default string 

NBSVER File version in file string or default 
string 

NBSWDI Wildcard directory in file string or 
default string 

NBSWNA Wildcard file name in file string or 
default string 

NBSWTY Wildcard file type in file string or 
default string 

NBSWVE Wildcard file version in file string or 
default string 

NBSWCH Wildcard context established (cleared) 


NAM RSL Resultant string length (bytes) 
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5.26 SRENAME MACRO 


The SRENAME macro calls the RENAME operation routine to change the 
directory entry for a file. 


The old and new entries (file specifications) must have the same 
network node and device specifications, 


FORMAT 
The format for the SRENAME is: 
SRENAME oldfabaddr,[erraddr], [sucaddr] ,newfabaddr 


where oldfabaddr is the address of the FAB for the operation; erraddr 
is the address of the error handler for the operation; sucaddr is the 
address of the success handler for the operation; and newfabaddr is 
the address of the FAB giving the new file specification. 


CONTROL BLOCKS 


You must supply two FABs for the RENAME operation: an "“old" FAB 
containing the current specification for the file, and a "new" FAB 
containing the new specification for the file. 


If you supply a NAM block for the old FAB (old NAM block) and specify 
either rename by NAM block or wildcarding, the RENAME operation reads 
its fields to obtain identifiers for the old file specification. LE 
you supply a NAM block for the new FAB (new NAM block) and specify 
rename by NAM block, the RENAME operation reads its fields to obtain 
identifiers for the new file specification. 


To supply a NAM block for the RENAME operation, specify the address of 
the NAM block in the l-word NAM field of the FAB. 


To supply XABsS (ALL, DAT, KEY, PRO, and SUM blocks) for the RENAME 
Operation, specify the address of the first XAB in the l-word XAB 
field of the FAB; specify the address of the next XAB (if any) in the 
l-word NXT field of each XAB; specify 0 in the NXT field of the last 
XAB. 


All KEY blocks must be together in the chain of XABs, and must’ be in 
ascending order (by the index reference number in the 1l-byte REF field 
of the KEY block); the index reference numbers need not be 
consecutive. 


All ALL blocks must be together in the chain of XABs, and must be in 
ascending order (by the area identifier in the l-byte AID field of the 
ALL block); the area identifiers need not be consecutive. 


Multiple DAT, PRO, or SUM XABs are illegal. 


OPTIONS 


Old File Specification (Nonwildcard RENAME Operation) 


The RENAME operation constructs the full file specification from the 
file string, the default string (which contributes only elements not 
present in the file string), and RMS-1ll defaults (which contribute 
elements not present in either the file string or the default string). 
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RMS-11 defaults are: 


@ Device -- The device to which the specified logical channel is 
assigned, or SY: if the specified logical channel is not 
assigned to any device. 


@ Directory -- The current directory for the task. 
e Name, type, version -- Defaulted to null. 
The file string and the default string must not contain wildcards. 


Specify the address of the file string in the l-word FNA field of the 
FAB. Specify the size (in bytes) of the file string in the l-byte FNS 
field of the FAB; if you specify 0 in the FNS field, the RENAME 
operation uses no file string. 


Specify the address of the default string in the l-word DNA field of 
the FAB. Specify the size (in bytes) of the default string in the 
l-byte DNS field of the FAB; if you specify 0 in the DNS field, the 
RENAME operation uses no default string. 


If you set the FBSFID mask in the l-word FOP field of the FAB and 
supply a NAM block, the RENAME operation reads the device identifier 
from the 2-word DVI field of the NAM block; if this value is nonzero, 
the specified device overrides the device in the merged string. 


In the same circumstance, the RENAME operation reads the directory 
identifier from the 3-word DID field of the NAM block; if this value 
is nonzero, the specified directory overrides the directory in the 
merged string. 


Old File Specification (Wildcard RENAME Operation) 


You can use the RENAME operation in a wildcarding program loop. (The 
NBSWCH mask in the l-word FNB field of the NAM block will already have 
been set by an earlier PARSE operation.) 


If you set the FBSFID mask in the l-word FOP field of the FAB, the 
file found by a previous SEARCH operation is renamed without affecting 
fields that are used as context for subsequent SEARCH operations. 


If you clear the FBSFID mask in the l-word FOP field of the FAB, the 
RENAME operation first performs an implicit SEARCH operation. (The 
input and output fields for the SEARCH operation are not described 
here and are not included in the checklists at the end of this 
section.) 


If the SEARCH operation finds a file that matches the wildcard file 
specification, the RENAME operation replaces its directory entry; if 
not, the RENAME operation does not replace a directory entry, but 
instead passes control block data from the SEARCH operation (in 
particular, the ERSNMF completion status code and the cleared NBSWCH 
mask in the l-word FNB field of the NAM block). 


New File Specification 
The RENAME operation constructs the full file specification from _ the 
file string, the default string (which contributes only elements not 


present in the file string), and RMS-ll defaults (which contribute 
elements not present in either the file string or the default string). 
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RMS-1l defaults are: 


e Device -- The device that was used for the old file 
specification (The old FAB logical channel is used, and the 
new FAB logical channel is ignored). 


@e Directory -- The current directory for the task. 
@ Name, type, version -- Defaulted to null. 
The file string and the default string must not contain wildcards. 


Specify the address of the file string in the l-word FNA field of the 
FAB. Specify the size (in bytes) of the file string in the l-byte FNS 
field of the FAB; if you specify 0 in the FNS field, the RENAME 
operation uses no file string. 


Specify the address of the default string in the l-word DNA field of 
the FAB. Specify the size (in bytes) of the default string in the 
l-byte DNS field of the FAB; if you specify 0 in the DNS field, the 
RENAME operation uses no default string. 


If you set the FBSFID mask in the l-word FOP field of the FAB and 
supply a NAM block, the RENAME operation reads the device identifier 
from the 2-word DVI field of the NAM block; if this value is nonzero, 
the specified device overrides the device in the merged string. 


In the same circumstance, the RENAME operation reads the directory 
identifier from the 3-word DID field of the NAM block; if this value 
is nonzero, the specified directory overrides the directory in the 
merged string. 


Private Buffer Pool 


If you want the RENAME operation to use a private buffer pool instead 
of the central buffer pool, specify the address of the (word-aligned) 
private buffer pool in the l-word BPA field of the FAB, and its size 
(in bytes) in the l-word BPS field of the FAB; this size must be a 
multiple of 4. 


If you specify 0 in either the BPA field or the BPS field, the RENAME 
operation uses the central buffer pool. 


Logical Channel 


Specify the logical channel for the RENAME operation in the 1l-byte LCH 
field of the FAB. The logical channel number must not be the same as 
the logical channel number for any already-open file, and must not be 
0. 


Expanded String Buffers 


If you want the expanded string for the file given by a FAB returned 
to a buffer, supply a NAM block for the FAB. Specify the address of 
the buffer in the l-word ESA field of the NAM block, and the size (in 
bytes) of the buffer in the l-byte ESS field of the NAM block. If you 
do not supply a NAM block for a FAB, or if you specify 0 in the _ ESS 
field, the RENAME operation does not return the expanded string. 
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RETURNED VALUES 


Expanded Strings 


If you specify a buffer for the expanded string for a FAB (ESA and ESS 
fields in the NAM block), the RENAME operation writes the expanded 
string in the buffer, and writes the length (in bytes) of the string 
in the l-byte ESL field of the NAM block. 


Device Characteristics 


The RENAME operation returns device characteristics as masks in the 
l-byte DEV field of the FAB. The device characteristics are: 


@e Printer or terminal (indicated by the set FBSCCL mask in the 
l-byte DEV field of the FAB and the set FBSREC mask in the 
l-byte DEV field of the FAB; for a terminal, the FBSTRM mask 
in the 1l-byte DEV field of the FAB is also set); RMS-1l1l 
treats a printer or terminal as a unit-record device. 


e Disk, DECtape, or DECTAPE II (indicated by the set FBSMDI mask 
in the 1-byte DEV field of the FAB); RMS-1ll treats a disk, 
DECtape, or DECTAPE II as a disk device. 


@e Unit-record device (indicated by the set FBSREC mask in the 
l-byte DEV field of the FAB). 


@e Non-ANSI magtape or cassette tape (indicated by the set FBSSDI 
mask in the 1l-byte DEV field of the FAB and the set FBSREC 
mask in the l-byte DEV field of the FAB); RMS-l1l treats a 
non-ANSI magtape or a cassette tape as a unit-record device. 


e ANSI-format magtape (indicated by the set FBSSQD mask in the 
l-byte DEV field of the FAB). 


Device, Directory, and File Identifiers 


If you supply a NAM block, the RENAME operation writes a device 
identifier in the 2-word DVI field of the NAM block, a directory 
identifier in the 3-word DID field of the NAM block, and a file 
identifier in the 3-word FID field of the NAM block. 


File Specification Characteristics 


The RENAME operation sets masks in the l-word FNB field of the NAM 
block to show which file specification elements were present in the 
file string and default string. 


These masks and their meaning are: 


NBSNOD Node in file string or default string 

NBSDEV Device in file string or default string 

NBSDIR Directory in file string or default string 

NBSQUO Quoted string in file string or default string 
NBSNAM File name in file string or default string 

NBSTYP File type in file string or default string 

NBSVER File version in file string or default string 
NBSWDI Wildcard directory in file string or default string 
NBSWNA Wildcard file name in file string or default string 
NBSWTY Wildcard file type in file string or default string 
NBSWVE Wildcard file version in file string or default string 
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Wildcarding 


The RENAME operation clears the NBSWCH mask in the l-word FNB field of 
the NAM block; this shows that no wildcard context exists after the 
RENAME operation. It also clears the l-byte RSL field of the NAM 
block to show that no resultant string was returned. 


Completion Status and Value 


The RENAME operation returns completion status in the l-word STS field 
of the FAB and returns a completion value in the l-word STV field of 
the FAB. Appendix A lists completion status symbols and values. 


CHECKLISTS 


Table 5-51 lists control block fields that are input to the RENAME 
operation. Table 5-52 lists control block fields that are output by 
the RENAME operation. 


NOTE 


The only input fields taken from _ both 
the "old" and the "new" FABS are the 
DNA, DNS, FNA, FNS, FOP, and NAM fields. 
All other FAB input fields are taken 
from the "old" FAB only. All FAB output 
fields are returned to the "old" FAB 
only. 


Table 5-51: RENAME Input Fields 


Block Field Description 


ALL NXT Next XAB address 

DAT NXT Next XAB address 

FAB BPA Private buffer pool address 

FAB BPS Private buffer pool size (bytes) 
FAB DNA Default string address 

FAB DNS Default string size (bytes) 

FAB FNA File string address 

FAB FNS File string size (bytes) 

FAB FOP File processing option mask 


FBSFID Use information in NAM block 


FAB LCH Logical channel number 

FAB NAM NAM block address 

KEY NXT Next XAB address 

NAM DID Directory identifier 

NAM DVI Device identifier 

NAM ESA Expanded string buffer address 

NAM ESS Expanded string buffer size (bytes) 
NAM FNB File specification mask 


NBSWCH Wildcard context established 


PRO NXT Next XAB address 
SUM NXT Next XAB address 
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Table 5-52: RENAME Output Fields 


Block Field Description 


FAB DEV Device characteristic mask 


FBSCCL Carriage-control device 
FBSMDI Multidirectory device 
FBSREC Record-oriented device 
FBSSDI Single-directory device 
FBSSQD Sequential device 
FBSTRM Terminal device 


FAB STS Completion status code 

FAB STV Completion status value 

NAM DID Directory identifier 

NAM DVI Device identifier 

NAM ESL Expanded string length (bytes) 
NAM FID File identifier 

NAM ENB File specification mask 


NBSNOD Node in file string or default string 

NBSDEV Device in file string or default string 

NBSDIR Directory in file string or default string 

NBSQUO Quoted string in file string or default 
string 

NBSNAM File name in file string or default string 

NBSTYP File type in file string or default string 

NBSVER File version in file string or default 
string 

NBSWDI Wildcard directory in file string or 
default string 

NBSWNA Wildcard file name in file string or 
default string 

NBSWTY Wildcard file type in file string or 
default string 

NBSWVE Wildcard file version in file string or 
default string 

NBSWCH Wildcard context established (cleared) 


NAM RSL Resultant string length (bytes) 
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5.27 S$REWIND MACRO 
The SREWIND macro calls the REWIND operation routine to reset’ the 
context for a stream to the beginning-of-file. The file can have any 
organization. 
FORMAT 
The format for the SREWIND is: 

SREWIND rabaddr[,[erraddr] [,sucaddr] } 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the REWIND operation. 


OPTIONS 


Internal Stream Identifier 


The REWIND operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 


Key of Reference 


For an indexed file, you must specify the index that the stream will 
use in accessing records. Specify this key of reference in the l-byte 
KRF field of the RAB. This value matches the value in the file's KEY 
block for the index: 0 for the primary index, 1 for the first 
alternate index, and so forth. 


Asynchronous Operation 


If you want to execute the REWIND operation asynchronously, set the 
RBSASY mask in the 1-word ROP field of the RAB; if you do not set 
this mask, the REWIND operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


STREAM CONTEXT 

For a record access file, the current context after a REWIND operation 
is undefined and the next-record context is the first record in the 
file; for an indexed file, this first record is defined by the 


specified index. 


For a block access file, both the readable-block and writable-block 
contexts after a REWIND operation are the first block in the file. 
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RETURNED VALUES 


Completion Status and Value 


The REWIND operation returns completion status in the l-word STS field 


of the RAB 
the RAB. App 
CHECKLISTS 
Table 5-53 li 


operation. 
the REWIND op 


Block Field 


RAB ISI 
RAB KRF 
RAB ROP 


Block Field 


RAB STS 
RAB STV 


and returns a completion value in the l-word STV field of 
endix A lists completion status symbols and values. 


sts control block fields that are input to the REWIND 
Table 5-54 lists control block fields that are output by 
eration. 


Table 5-53: REWIND Input Fields 


Description 


Internal stream identifier 
Key of reference 
Record processing option mask 


RBSASY Asynchronous operation 


Table 5-54: REWIND Output Fields 


Description 


Completion status code 
Completion status value 


5-115 


OPERATION MACRO DESCRIPTIONS 
SSEARCH MACRO 


5.28 SSEARCH MACRO 


The SSEARCH macro calls the SEARCH operation routine to scan a 
directory and return a file specification and identifiers in NAM block 
fields. You should precede the SEARCH operation by a PARSE operation, 
which initializes the NAM block fields for the SEARCH operation. 


The SEARCH operation finds a file specification that matches’ the 
match-pattern initialized (in the expanded string buffer) by the PARSE 
operation; a series of wildcard SEARCH operations returns successive 
matching file specifications. 


FORMAT 
The format for the SSEARCH is: 
SSEARCH fabaddr[,[erraddr]} [,sucaddr] } 


where fabaddr is the address of the FAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 
You must supply a FAB for the SEARCH operation. 
You must supply a NAM block for the SEARCH operation. 


To supply a NAM block for the SEARCH operation, specify the address of 
the NAM block in the l-word NAM field of the FAB. 


To supply XABsS (ALL, DAT, KEY, PRO, and SUM blocks) for the SEARCH 
Operation, specify the address of the first XAB in the l-word XAB 
field of the FAB; specify the address of the next XAB (if any) in the 
l-word NXT field of each XAB; specify 0 in the NXT field of the last 
XAB. 


All KEY blocks must be together in the chain of XABs, and must be in 
ascending order (by the index reference number in the l-byte REF field 
of the KEY block); the index reference numbers need not be 
consecutive. 


All ALL blocks must be together in the chain of XABS, and must be in 
ascending order (by the area identifier in the l-byte AID field of the 
ALL block); the area identifiers need not be consecutive. 


Multiple DAT, PRO, or SUM XABs are illegal. 
OPTIONS 


Wildcard Context Information 


The SEARCH operation reads NAM block fields that are initialized, 
written, or preserved by a preceding PARSE or wildcard SEARCH 
Operation: the 3-word DID field of the NAM block, the 2-word DVI 
field of the NAM block, the l-word ESA field of the NAM block, the 
l-byte ESL field of the NAM block, the NBSWCH mask in the 1l-word FNB 
field of the NAM block, the l-word RSA field of the NAM block, the 
l-byte RSL field of the NAM block, the l-byte RSS field of the NAM 
block, the l-word WCC field of the NAM block, and the l-word WDI field 
of the NAM block. 
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The SEARCH operation also uses the expanded string in the expanded 
string buffer. 


You must preserve these fields between a PARSE and a SEARCH operation 
and between successive wildcard SEARCH operations. 


Private Buffer Pool 


If you want the SEARCH operation to use a private buffer pool instead 
of the central buffer pool, specify the address of the (word-aligned) 
private buffer pool in the l-word BPA field of the FAB, and its’ size 
(in bytes) in the l-word BPS field of the FAB; this size must be a 
multiple of 4. 


If you specify 0 in either the BPA field or the BPS field, the SEARCH 
Operation uses the central buffer pool. 


Logical Channel 


Specify the logical channel for the SEARCH operation in the 1-byte LCH 
field of the FAB. The logical channel number must not be the same as 


the logical channel number for any already-open file, and must not be 
0. 


Magtape Positioning 


The FBSRWO mask in the l-word FOP field of the FAB may be set to cause 
a magtape to be rewound prior to the first wildcard SEARCH operation. 
To avoid unpredictable results, the FBSRWO mask in the 1l-word FOP 
field of the FAB and FBSRWC mask in the l-word FOP field of the FAB 
should not be set thereafter. 


RETURNED VALUES 


Resultant String 


The SEARCH operation writes the full file specification for the found 
file in the resultant string buffer, and writes the length of the 
string in the l-byte RSL field of the NAM block. 


Device Characteristics 


The SEARCH operation returns device characteristics as masks in the 
l-byte DEV field of the FAB. The device characteristics are: 


e Printer or terminal (indicated by the set FBSCCL mask in the 
l-byte DEV field of the FAB and the set FBSREC mask in the 
l-byte DEV field of the FAB; for a terminal, the FBSTRM mask 
in the 1l-byte DEV field of the FAB is also set); RMS-11 
treats a printer or terminal as a unit-record device. 


@e Disk, DECtape, or DECTAPE II (indicated by the set FBSMDI mask 
in the l-byte DEV field of the FAB); RMS-11l treats a disk, 
DECtape, or DECTAPE II as a disk device. 


@e Unit-record device (indicated by the set FBSREC mask in the 
l-byte DEV field of the FAB). 
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e Non-~-ANSI magtape or cassette tape (indicated by the set FBSSDI 
mask in the 1l-byte DEV field of the FAB and the set FBSREC 
mask in the l-byte DEV field of the FAB); RMS-1ll treats a 
non-ANSI magtape or a cassette tape as a unit-record device. 


e ANSI-format magtape (indicated by the set FBSSQD mask in the 
l-byte DEV field of the FAB). 


Directory and File Identifiers 


If the SEARCH operation finds a file that matches the wildcard 
pattern, it writes the directory identifier for the found file in the 
3-word DID field of the NAM block, and the file identifier in the 
3-word FID field of the NAM block. 


Wildcard Context Information 
The SEARCH operation writes the wildcard context in the 1l-word WCC 
field of the NAM block, and the wildcard directory context in the 
l-word WDI field of the NAM block. 
If the SEARCH operation did not find a matching file, it clears’ the 
NBSWCH mask in the l-word FNB field of the NAM block; this shows that 
no further wildcarding is possible using the current wildcard 
information. 
Completion Status and Value 
The SEARCH operation returns completion status in the l-word STS field 
of the FAB and returns a completion value in the l-word STV field of 
the FAB. Appendix A lists completion status symbols and values. 
CHECKLISTS 
Table 5-55 lists control block fields that are input to the SEARCH 
operation. Table 5-56 lists control block fields that are output by 
the SEARCH operation. 

Table 5-55: SEARCH Input Fields 


Block Field Description 


ALL NXT Next XAB address 

DAT NXT Next XAB address 

FAB BPA Private buffer pool address 

FAB BPS Private buffer pool size (bytes) 
FAB FOP File processing option mask 


FBS RWO Rewind magtape before operation 
FBSRWC Rewind magtape after closing file 


FAB LCH Logical channel number 
FAB NAM NAM block address 
KEY NXT Next XAB address 


(Continued on next page) 
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NAM 
NAM 
NAM 
NAM 
NAM 


NAM 
NAM 
NAM 
NAM 
NAM 
PRO 
SUM 


Block Field 


FAB 


FAB 
FAB 
NAM 
NAM 
NAM 


NAM 
NAM 
NAM 


DID 
DVI 
ESA 
ESL 
FNB 


RSA 
RSL 
RSS 
WCC 
WDI 
NXT 
NXT 


DEV 


STS 
STV 
DID 
FID 
FNB 


RSL 
WCC 
WDI 
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Table 5-55 (Cont.): SEARCH Input Fields 


Description 


Directory identifier 

Device identifier 

Expanded string buffer address 
Expanded string length (bytes) 
File specification mask 


NBSWCH Wildcard context established 


Resultant string buffer address 
Resultant string length (bytes) 
Resultant string buffer size (bytes) 
Wildcard context 

Wildcard directory context 

Next XAB address 

Next XAB address 


Table 5-56: SEARCH Output Fields 


Description 


Device characteristic mask 


FBSCCL Carriage-control device 
FBSMDI Multidirectory device 
FBSREC Record-oriented device 
FBSSDI Single-directory device 
FBSSQD Sequential device 
FBSTRM Terminal device 


Completion status code 
Completion status value 
Directory identifier 
File identifier 

File specification mask 


NBSWCH Wildcard context established 
Resultant string length (bytes) 


Wildcard context 
Wildcard directory context 
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5.29 SSPACE MACRO 


The SSPACE macro calls the SPACE operation routine to move a magtape 
backward or forward. 


FORMAT 
The format for the SSPACE is: 
SSPACE rabaddr[,ferraddr] [,sucaddr] ] 
where rabaddr is the address of the RAB for the operation; erraddr is 


the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the SPACE operation. 
OPTIONS 


Internal Stream Identifier 

The SPACE operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 

Spacing Interval 

Specify the number of blocks to move the magtape in the first word of 
the 2-word BKT field of the RAB. A positive number spaces forward; a 
negative number spaces backward. 

Asynchronous Operation 

If you want to execute the SPACE operation asynchronously, set the 
RBSASY mask in the 1l-word ROP field of the RAB; if you do not set 
this mask, the SPACE operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


STREAM CONTEXT 


The readable-block context after a SPACE operation is the _ target 
block; the writable-block context after a SPACE operation is the 
target block. 


RETURNED VALUES 
Completion Status and Value 
The SPACE operation returns completion status in the l-word STS field 


of the RAB and returns a completion value in the l-word STV field of 
the RAB. Appendix A lists completion status symbols and values. 
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CHECKLISTS 
Table 5-57 lists control block fields that are input to the SPACE 
operation. Table 5-58 lists control block fields that are output by 
the SPACE operation. 

Table 5-57: SPACE Input Fields 


Block Field Description 


RAB BKT Virtual block number (VBN) increment 
RAB ISI Internal stream identifier 
RAB ROP Record processing option mask 


RBSASY Asynchronous operation 


Table 5-58: SPACE Output Fields 


Block Field Description 


RAB STS Completion status code 
RAB STV Completion status value 
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5.30 $TRUNCATE MACRO 
The STRUNCATE macro calls the TRUNCATE operation routine to remove 
records from the latter part of a sequential file; records are 
removed inclusively from the current record through the end-of-file. 
If the file cannot be truncated, the TRUNCATE operation returns an 
error completion and leaves the current-record context undefined and 
the next-record context unchanged. 
FORMAT 
The format for the STRUNCATE is: 

STRUNCATE rabaddr[, [erraddr] [,sucaddr] ] 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the TRUNCATE operation. 


OPTIONS 


Internal Stream Identifier 

The TRUNCATE operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 

Asynchronous Operation 

If you want to execute the TRUNCATE operation asynchronously, set the 
RBSASY mask in the 1l-word ROP field of the RAB; if you do not set 
this mask, the TRUNCATE operation executes synchronously. (Your 
program must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 

STREAM CONTEXT 

The TRUNCATE operation destroys the current-record context; the 
next-record context after the TRUNCATE operation is the end-of-file. 


RETURNED VALUES 


Completion Status and Value 


The TRUNCATE operation returns completion status in the 1l-word stTsSs 
field of the RAB and returns a completion value in the l-word STV 
field of the RAB. Appendix A lists completion status symbols” and 
values. 
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CHECKLISTS 


Table 5-59 lists control block fields that are input to the TRUNCATE 
operation. Table 5-60 lists control block fields that are output by 
the TRUNCATE operation. 


Table 5-59: TRUNCATE Input Fields 


Block Field Description 


RAB ISI Internal stream identifier 
RAB ROP Record processing option mask 


RBSASY Asynchronous operation 


Table 5-60: TRUNCATE Output Fields 


Block Field Description 


RAB STS Completion status code 
RAB STV Completion status value 
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5.31 S$UPDATE MACRO 
The SUPDATE macro calls the UPDATE operation routine to transfer a 
record from a user buffer to a disk file (overwriting the existing 
record). The target of the UPDATE operation is the current’ record, 
which is overwritten. 
If no record (as specified in the RAB) can be transferred, the UPDATE 
Operation returns an error completion. 
FORMAT 
The format for the SUPDATE is: 

SUPDATE rabaddr[,[erraddr] {[,sucaddr] ] 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the UPDATE operation. 
OPTIONS 


Internal Stream Identifier 


The UPDATE operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 


Record Buffer 


Specify the address of the record buffer in the l-word RBF field of 
the RAB, and specify the size (in bytes) of the record buffer in the 
l-word RSZ field of the RAB. For sequential files and for indexed 
files in which duplicate primary key values are permitted, the size of 
the buffer must be the same as the size of the existing record. 


If the file has VFC format, specify the address of the buffer for the 
VFC header in the l-word RHB field of the RAB; if you specify zero in 
this field, the existing record header will remain unchanged. 


Asynchronous Operation 


If you want to execute the UPDATE operation asynchronously, set the 
RBSASY mask in the I1l-word ROP field of the RAB; if you do not set 
this mask, the UPDATE operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


Bucket Fill Number Honoring 
If you want the UPDATE operation to honor bucket fill numbers for’ the 
file and its areas, set the RBSLOA mask in the l-word ROP field of the 


RAB. If you do not set this mask, the UPDATE operation fills buckets 
without regard to bucket fill numbers. 
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STREAM CONTEXT 


The UPDATE operation destroys the current-record context; the 
next-record context after the UPDATE operation is unchanged. 


RETURNED VALUES 


Completion Status and Value 


The UPDATE operation returns completion status in the l-word STS field 
of the RAB and returns a completion value in the l-word STV field of 
the RAB. Appendix A lists completion status symbols and values. 


CHECKLISTS 


Table 5-61 lists control block fields that are input to the UPDATE 
Operation. Table 5-62 lists control block fields that are output by 
the UPDATE operation, 


Table 5-61: UPDATE Input Fields 


Block Field Description 


RAB ISI Internal stream identifier 
RAB RBF Record buffer address 

RAB RHB VFC control buffer address 
RAB ROP Record processing option mask 


RBSASY Asynchronous operation 
RBSLOA Honor bucket fill numbers 


RAB RSZ Record size (bytes) 


Table 5-62: UPDATE Output Fields 


Block Field Description 


RAB STS Completion status code 
RAB STV Completion status value 
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5.32 SWAIT MACRO 

The SWAIT macro calls the WAIT operation routine to suspend processing 
until an outstanding asynchronous operation on the stream is 
completed. The WAIT operation does not affect stream context. The 


WAIT operation cannot be used within any asynchronous operation's 
completion routine. 


FORMAT 
The format for the SWAIT is: 
SWAIT rabaddr 


where rabaddr is the address of the RAB for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the WAIT operation. 


OPTIONS 


Internal Stream Identifier 

The WAIT operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 

STREAM CONTEXT 

The WAIT operation does not affect stream context. The stream context 
after the WAIT operation is the context established by the outstanding 
asynchronous operation; if there is no outstanding asynchronous 
Operation for the stream, the stream context is unchanged. 


RETURNED VALUES 


The WAIT operation returns no values. 


CHECKLISTS 


Table 5-63 lists control block fields that are input to the WAIT 
operation. 


Table 5-63: WAIT Input Fields 


Block Field Description 


RAB ISI Internal stream identifier 
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5.33 S$WRITE MACRO (SEQUENTIAL ACCESS) 


The SWRITE macro calls the WRITE operation routine to write blocks to 
a file. The target of a sequential-access WRITE operation is the 
writable block (and, for a multiblock WRITE operation, following 
blocks). 


FORMAT 
The format for the SWRITE is: 

SWRITE rabaddr[,[erraddr] [,sucaddr] ] 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 
CONTROL BLOCKS 


You must supply a RAB for the WRITE operation. 


OPTIONS 


Internal Stream Identifier 


The WRITE operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 


Block Identification 


For a sequential-access WRITE operation, specify 0 in the 2-word BRKT 
field of the RAB. 


Record Buffer 


Specify the address of the record buffer in the l-word RBF field of 
the RAB, and specify the size (in bytes) of the record buffer in the 
l-word RSZ field of the RAB. You must specify a record buffer for the 
WRITE operation; the WRITE operation transfers data from this buffer 
to the file. 


The WRITE operation normally updates the logical end-of-file marker, 
when appropriate, and automatically extends the file's allocation, 
when necessary. For sequential files with undefined (UDF) record 
format, however, the WRITE operation updates the logical end-of-file 
marker and performs automatic file extensions only if no write-sharing 
has been specified in the 1-byte SHR field of the FAB. 


Asynchronous Operation 


If you want to execute the WRITE operation asynchronously, set the 
RBSASY mask in the 1l-word ROP field of the RAB; if you do not set 
this mask, the WRITE operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 
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STREAM CONTEXT 

The readable-block context after a WRITE operation is the _ block 


following the last-written block; the writable-block context after a 
WRITE operation is the block following the last-written block. 


RETURNED VALUES 


Record File Address (RFA) 

The WRITE operation returns the virtual block number of the 
first-written block in the first two words of the 3-word RFA field of 
the RAB (it clears the third word). 

Completion Status and Value 

The WRITE operation returns completion status in the l-word STS field 
of the RAB and returns a completion value in the l-word STV field of 
the RAB. Appendix A lists completion status symbols and values. 
CHECKLISTS 

Table 5-64 lists control block fields that are input to the WRITE 
operation. Table 5-65 lists control block fields that are output by 
the WRITE operation. 


Table 5-64: WRITE (Sequential Access) Input Fields 


Block Field Description 


RAB BRKT Virtual block number (VBN) 
RAB ISI Internal stream identifier 
RAB RBF Record buffer address 

RAB ROP Record processing option mask 


RBSASY Asynchronous operation 


RAB RSZ Record size (bytes) 


Table 5-65: WRITE (Sequential Access) Output Fields 


Block Field Description 


RAB RFA Virtual block number (2 words) 
RAB STS Completion status code 
RAB STV Completion status value 
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5.34 SWRITE MACRO (VBN ACCESS) 
The SWRITE macro calls the WRITE operation routine to write blocks to 
a file. The target of a VBN-access WRITE operation is the writable 
block (and, for a multiblock WRITE operation, following blocks). 
FORMAT 
The format for the SWRITE is: 

SWRITE rabaddr[, {erraddr] [,sucaddr] } 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 
CONTROL BLOCKS 


You must supply a RAB for the WRITE operation. 


OPTIONS 


Internal Stream Identifier 


The WRITE operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 


Block Identification 


Specify the virtual block number of the first block to be written in 
the 2-word BKT field of the RAB. 


Record Buffer 


Specify the address of the record buffer in the l-word RBF field of 
the RAB, and specify the size (in bytes) of the record buffer in the 
l-word RSZ field of the RAB. You must specify a record buffer for the 
WRITE operation; the WRITE operation transfers data from this buffer 
to the file. 


The WRITE operation normally updates the logical end-of-file marker, 
when appropriate, and automatically extends the file's allocation, 
when necessary. For sequential files with undefined (UDF) record 
format, however, the WRITE operation updates the logical end-of-file 
marker and performs automatic file extensions only if no write-sharing 
has been specified in the l-byte SHR field of the FAB. 


Asynchronous Operation 


If you want to execute the WRITE operation asynchronously, set the 
RBSASY mask in the 1l-word ROP field of the RAB; if you do not set 
this mask, the WRITE operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 
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STREAM CONTEXT 

The readable~block context after a WRITE operation is the block 


following the last-written block; the writable-block context after a 
WRITE operation is the block following the last-written block. 


RETURNED VALUES 


Record File Address (RFA) 

The WRITE operation returns the virtual block number of the 
fFirst-written block in the first two words of the 3-word RFA field of 
the RAB (it clears the third word). 

Completion Status and Value 

The WRITE operation returns completion status in the l-word STS field 
of the RAB and returns a completion value in the l-word STV field of 
the RAB. Appendix A lists completion status symbols and values. 
CHECKLISTS 

Table 5-66 lists control block fields that are input to the WRITE 
operation. Table 5-67 lists control block fields that are output by 
the WRITE operation. 


Table 5-66: WRITE (VBN Access) Input Fields 


Block Field Description 


RAB BKT Virtual block number (VBN) 
RAB ISI Internal stream identifier 
RAB RBF Record buffer address 

RAB ROP Record processing option mask 


RBSASY Asynchronous operation 


RAB RSZ Record size (bytes) 


Table 5-67: WRITE (VBN Access) Output Fields 


Block Field Description 


RAB RFA Virtual block number (2 words) 
RAB STS Completion status code 
RAB STV Completion status value 
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CONTROL BLOCK FIELDS 


Each major section of this chapter describes an RMS-11l control block, 
and includes: 


Block summary table 


A table summarizes the entire control block. The table shows 
the offset, offset symbol, field size, and a brief description 
of each field in the block; for each mask or code for a 
field, the table shows the value, symbol, and a brief 
description of the mask or code. 


Field summaries 

Each subsection following the block summary table is a 
description of one field in the block. A field that has masks 
that are very different in purpose (such as the FOP field in 
the FAB) is described as a number of separate "fields" (such 
as FOP FBSFID, FOP FBSRWO, and so forth). 

The description of each field includes the following: 

USE: a summary of the purpose of the field 

SIZE: the size of the field 


INIT: the format of the field-initialization macro (if any) 


ACCESS: the formats of field-access macros to access’ the 
field 


MASKS or CODES: (if any) each mask or code symbol and a brief 
description 


INPUT: the operations that read values from the field, and 
the meanings of those values 


OUTPUT: the operations that store values in the field, and 
the meanings of those values 


Fields described as "Reserved" and undefined bits in masks should (and 
in some cases must) be 0. 


CONTROL BLOCK FIELDS 

ALL BLOCK SUMMARY 

6.1 ALL BLOCK SUMMARY 

This section summarizes the ALL block and its fields. Table 6-1 
summarizes the entire block, giving the offset, offset symbol, size, 
and a brief description for each field; for a field that has mask or 


code symbols, the table also gives the value, symbol, and a brief 
description for each mask or code. 


Table 6-1: ALL Block Summary 


Offset Field 
Offset Symbol Size Description 
000 OSCOD l byte ALL block identifier code 
000004 xXBSALL ALL block identifier 
001 OSBLN l byte ALL block length (bytes) 


000034 xXBSLAL ALL block length (bytes) 


002 OSNXT 1 word Next XAB address 

004 OSAID 1 byte Area number 

005 OSBKZ 1 byte Area bucket size (blocks) 
006 OSVOL 1 word Reserved 

010 OSALN 1 byte Area alignment mask 


000002 XBSLBN Logical block alignment 
000004 XBSVBN Virtual block alignment 


011 OSAOP 1 byte Area option mask 


000001 XBSHRD Hard area location 
000002 XBSCTG Contiguous area 


012 OSALQ 2 words Area allocation size (blocks) 

012 OSALQO 1 word ALQ field low word 

014 OSALQ1L 1 word ALQ field high word 

016 OSDEQ 1 word Area default extension size (blocks) 
020 1 word Reserved 

022 OSLOC 2 words’) Area location 

022 OSLOCO 1 word LOC field low word 

024 OSLOC1 1 word LOC field high word 


SS es TT nan ns 


6.1.1 


USE 


INIT 
SIZE 


ACCESS 


INPUT 
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AID Field in ALL Block 


Contains the area identifier for the area described by the 
ALL block. 


XSAID number 


1 byte 

SFETCH dst,AID,reg ;AID field to l-byte dst 
SSTORE src,AID,reg ;l-byte src to AID field 
SCOMPARE src,AID,reg ;l-byte src with AID field 
CLOSE Area number 

CREATE Area number 

DISPLAY Area number 

EXTEND Area number 

OPEN Area number 
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ALL BLOCK SUMMARY 


6.1.2 


USE 


INIT 


SIZE 


ACCESS 


MASKS 


INPUT 


OUTPUT 


Indicates alignment for the 


block. 


ALN Field in ALL Block 


area described by the 


XSALN mask 


l byte 


SSET mask,ALN,reg 
SOFF mask,ALN,reg 


;Mask bits on in ALN field 
;Mask bits off in ALN field 


STESTBITS mask,ALN,reg ;Test mask bits in ALN field 


SFETCH dst,ALN,reg 
SSTORE src,ALN,reg 
SCOMPARE src,ALN,reg 


XBSLBN 
XBSVBN 


CREATE 
EXTEND 


DISPLAY 


OPEN 


;ALN field to l-byte dst 
;l-byte src to ALN field 
;l-byte src with ALN field 


Logical block alignment 
Virtual block alignment 


Initial area alignment request 
Area extension alignment request 


Area alignment mask (cleared) 
Area alignment mask (cleared) 


ALL 
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6.1.3 ALQ Field in ALL Block 


USE Contains the allocation size for the area described by the 
ALL block. 


INIT XSALQ number 
SIZE 2 words 


ACCESS SFETCH dst,ALQ,reg ;ALQ field to 2-word dst 
SSTORE src,ALQ,reg ;2-word sre to ALQ field 
SFETCH dst,ALQn,reg sALQ word n to l-word dst 
SSTORE src,ALQn,reg ;l-word sre to ALQ word n 
SCOMPARE src,ALQn,reg ;l-word src with ALQ word n 


INPUT CREATE Initial area allocation request size (blocks) 
EXTEND Area allocation extension request size 
(blocks) 


OUTPUT CREATE Initial area allocation size (blocks) 
DISPLAY Unused area allocation size (blocks) 
EXTEND Area allocation extension actual size (blocks) 
OPEN Unused area allocation size (blocks) 
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6.1.4 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


OUTPUT 


AOP Field in ALL Block (XBS$CTG Mask) 


Indicates contiguity for the area 


block. 
XSAOP mask 
l byte 


SSET mask,AOP,reg 

SOFF mask,AOP,reg 
STESTBITS mask,AOP,reg 
SFETCH dst,AOP,reg 
SSTORE src,AOP,reg 
SCOMPARE src,AOP,reg 


CREATE Contiguous 
EXTEND Contiguous 
DISPLAY Contiguous 
OPEN Contiguous 


;Mask bits 
;Mask bits 
;Test mask 
;AOP field 


described by the 


on in AOP field 
off in AOP field 
bits in AOP field 
to l-byte dst 


;l-byte src to AOP field 
;l-byte src with AOP field 


area request 
area extension request 


area (cleared) 
area (cleared) 


ALL 
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6.1.5 AOP Field in ALL Block (XBSHRD Mask) 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


OUTPUT 


Indicates a demand for 


XSAOP mask 


SSET mask,AOP,reg 

SOFF mask,AOP,reg 
STESTBITS mask,AOP,reg 
SFETCH dst,AOP,reg 
SSTORE src,AOP,reg 
SCOMPARE src,AOP,reg 


the requested location. 


sMask bits on in AOP field 
s;Mask bits off in AOP field 
Test mask bits in AOP field 
;AOP field to l-byte dst 
;l-byte src to AOP field 
;l-byte sre with AOP field 


hard location request 
extension hard location request 


area location (cleared) 
area location (cleared) 
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6.1.6 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


OUTPUT 


BKZ Field in ALL Block 


Contains the bucket size for the area described by the ALL 
block. 


XSBKZ number 


l byte 

SFETCH dst,BKZ,reg ;BKZ field to l-byte dst 
SSTORE src,BKZ,reg ;l-byte src to BKZ field 
SCOMPARE src,BKZ,reg ;l-byte src with BKZ field 
CREATE Area bucket size (blocks) 

DISPLAY Area bucket size (blocks) 

OPEN Area bucket size (blocks) 
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6.1.7 BLN Field in ALL Block (XBSLAL Code) 


USE Contains the length of the ALL block. 

INIT None 

SIZE l byte 

ACCESS SFETCH dst,BLN,reg ;BLN field to l-byte dst 


SCOMPARE src,BLN,reg ;l-byte src with BLN field 
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6.1.8 COD Field in ALL Block (XBSALL Code) 


USE Contains the identifier for the ALL block. 

INIT None 

SIZE 1 byte 

ACCESS SFETCH dst,COD,reg ;COD field to l-byte dst 


SCOMPARE src,COD,reg ;l-byte sre with COD field 


6.1.9 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


OUTPUT 
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DEQ Field in ALL Block 


Contains the default extension size for the area described 
by the ALL block. 


XSDEQ number 


1 word 

SFETCH dst,DEQ,reg ;DEQ field to l-word dst 
SSTORE src,DEQ,reg ;l-word sre to DEQ field 
SCOMPARE src,DEQ,reg sl-word sre with DEQ field 
CREATE Area default extension size (blocks) 
DISPLAY Area default extension size (blocks) 
OPEN Area default extension size (blocks) 
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6.1.10 


USE 


INIT 
SIZE 


ACCESS 


INPOT 


LOC Field in ALL Block 


Contains the location of the area described by the ALL 
block. 


The meaning of the location depends on the ALN _ mask: a 
logical block number (if XBSLBN) or a virtual block number 
(if XBSVBN). 


XSLOC number 


2 words 

SFETCH dst,LOC,reg *LOC field to 2-word dst 
SSTORE src,LOC,reg *2-word sre to LOC field 
SFETCH dst,LOCn,reg ;LOC word n to l-word dst 
SSTORE src,LOCn,reg ;l-word sre to LOC word n 
SCOMPARE src,LOCn,reg ;l-word sre with LOC word n 
CREATE Initial area location request 

EXTEND Area extension location request 
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6.1.11 NXT Field in ALL Block 


USE Contains the address of the next XAB (ALL, DAT, KEY, PRO, 
or SUM block) in a chain of XABs. 
INIT XSNXT address 
SIZE 1 word 
ACCESS SFETCH dst,NXT,reg *NXT field to l-word dst 
SSTORE src,NXT,reg ;l-word sre to NXT field 
SCOMPARE src,NXT,reg ;l-word sre with NXT field 
INPUT CLOSE Next XAB address 
CREATE Next XAB address 
DISPLAY Next XAB address 
ENTER Next XAB address 
ERASE Next XAB address 
EXTEND Next XAB address 
OPEN Next XAB address 
PARSE Next XAB address 
REMOVE Next XAB address 
RENAME Next XAB address 
SEARCH Next XAB address 
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6.2 DAT BLOCK SUMMARY 


This section summarizes the DAT block and its fields. Table 6-2 
Summarizes the entire block, giving the offset, offset symbol, size, 
and a brief description for each field; for a field that has mask or 
code symbols, the table also gives the value, symbol, and a brief 
description for each mask or code. 


Table 6-2: DAT Block Summary 


Offset Field 
Offset Symbol Size Description 


000 OSCOD 1 byte DAT block identifier code 

000003 XBSDAT DAT block identifier 
001 OSBLN 1 byte DAT block length (bytes) 

000046 xXBSDTL DAT block length (bytes) 


002 OSNXT 
004 OSRVN 
006 OSRDT 
016 OSCDT 
026 OSEDT 
036 OSBDT 


word Next XAB address 
word File revision number 
words File revision date 
words File creation date 
words File expiration date 
words Reserved 


AS SS Se 
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6.2.1 BLN Field in DAT Block (XBSDTL Code) 


USE Contains the length of the DAT block. 

INIT None 

SIZE 1 byte 

ACCESS SFETCH dst,BLN,reg ;BLN field to l-byte dst 


SCOMPARE src,BLN,reg ;l-byte src with BLN field 
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6.2.2 


USE 


INIT 
SIZE 
ACCESS 


OUTPUT 


CDT Field in DAT Block 


Contains the binary creation date for the file. The time 
value is a binary number in 100-nanosecond units offset 
from the system base date and time, which is 00:00 
o'clock, November 17, 1858 (the Smithsonian base date and 
time for the astronomical calendar). 


None 

4 words 

SFETCH dst,CDT,reg s;CDT field to 4-word dst 
DISPLAY File creation date 

OPEN File creation date 


CONTROL BLOCK FIELDS 
DAT BLOCK SUMMARY 


6.2.3 COD Field in DAT Block (XBSDAT Code) 


USE Contains the identifier for the DAT block. 

INIT None 

SIZE 1 byte 

ACCESS SFETCH dst,COD,reg ;COD field to l-byte dst 


SCOMPARE src,COD,reg ;l-byte src with COD field 
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6.2.4 


USE 


INIT 
SIZE 
ACCESS 


OUTPUT 


EDT Field in DAT Block 


Contains the expiration date for the file. The time value 
is a binary number in 100-nanosecond units offset from the 
system base date and time, which is 00:00 o'clock, 
November 17, 1858 (the Smithsonian base date and time for 
the astronomical calendar). 


None 

4 words 

SFETCH dst,EDT,reg *;EDT field to 4-word dst 
OPEN File expiration date 

DISPLAY File expiration date 
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DAT BLOCK SUMMARY 


6.2.5 NXT Field in DAT Block 


USE Contains the address of the next XAB (ALL, DAT, KEY, PRO, 
or SUM block) in a chain of XABs. 
INIT XSNXT address 
SIZE 1 word 
ACCESS SFETCH dst,NxXT,reg s;NXT field to l-word dst 
SSTORE src,NXT,reg ;l-word sre to NXT field 
SCOMPARE src,NXT,reg :l-word sre with NXT field 
INPUT CLOSE Next XAB address 
CREATE Next XAB address 
DISPLAY Next XAB address 
ENTER Next XAB address 
ERASE Next XAB address 
EXTEND Next XAB address 
OPEN Next XAB address 
PARSE Next XAB address 
REMOVE Next XAB address 
RENAME Next XAB address 


SEARCH Next XAB address 
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6.2.6 


USE 


INIT 
SIZE 
ACCESS 


OUTPUT 


RDT Field in DAT Block 


Contains the binary revision date for the file. The time 
value is a binary number in 100-nanosecond units offset 
from the system base date and time, which is 00:00 
o'clock, November 17, 1858 (the Smithsonian base date and 
time for the astronomical calendar). 


None 

4 words 

SFETCH dst,RDT,reg ;RDT field to 4-word dst 
DISPLAY File revision date 

OPEN File revision date 


6.2.7 


USE 


INIT 
SIZE 


ACCESS 


OUTPUT 
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RVN Field in DAT Block 


Contains the revision number (number of times closed) for 
the file. 


None 

l word 

SFETCH dst,RVN,reg s;RVN field to l-word dst 
SCOMPARE src,RVN,reg s;l-word src with RVN field 
DISPLAY File revision number 

OPEN File revision number 
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6.3 FAB SUMMARY 
This section summarizes the FAB and its fields. Table 6-3 summarizes 
the entire block, giving the offset, offset symbol, size, and a brief 
description for each field; for a field that has mask or code 
symbols, the table also gives the value, symbol, and a brief 
description for each mask or code. 
Table 6-3: FAB Summary 
Offset Field 
Offset Symbol Size Description 
000 OSBID 1 byte FAB identifier 
000003 FBSBID FAB identification code 
001 OSBLN 1 byte FAB length (bytes) 
000120 FBSBLN FAB length (bytes) 
002 OSCTX 1 word User context 
004 OSIFI 1 word Internal file identifier 
006 OSSTS 1 word Completion status code 
010 OSSTV 1 word Completion status value 
012 OSALQ 2 words File allocation size (blocks) 
016 OSDEQ 1 word File default extension size (blocks) 
020 OSFAC 1 byte Requested access mask 
000001 FBSPUT Request put access 
000002 FBSGET Request find/get access 
000004 FBSDEL Request find/get/delete 
access 
000010 FBSUPD Request find/get/update 
access 
000020 FBSTRN Request find/get/truncate 
access 
000041 FBSWRT Request block write 
access 
000042 FBSREA Request block read access 
O21 OSSHR 1 byte Shared access mask 
000002 FBSGET Share find/get access 
000015 FBSWRI Share find/get/put/update/ 
delete access 
000040 FBSUPI Share any access 
(user-provided interlock) 
000100 FBSNIL No access sharing 


(Continued on next page) 


Offset 


022 


024 
025 


026 


027 


Offset 
Symbol 


OSFOP 


OSRTV 
OSORG 


OSRAT 


OSREM 


Table 6-3 (Cont.): 


Field 
Size 


1 word 


1 byte 
1 byte 


1 byte 


1 byte 


Description 


File processing 


000001 
000002 
000010 
000020 
000200 
000400 
001000 
002000 
004000 
006000 
010000 


020000 


FBSRWO 
FBSRWC 
FBSPOS 
FBSDLK 
FBSCTG 
FBSSUP 
FBSNEF 
FBSTMP 
FBSMKD 
FBS TMD 
FBSFID 


FBSDFW 


FAB 
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Summary 


option mask 


Rewind magtape before 
operation 

Rewind magtape after 
closing file 

Position magtape after 
last-closed file 

No file locking on 
abnormal close 
Contiguous file 
Supersede existing file 
No end-of-file magtape 
positioning 

Temporary file 

Mark file for deletion 
Temporary file, mark for 
deletion 

Use information in NAM 
block 

Defer writing 


Retrieval pointer count 
File organization code 


000000 
000020 
000040 
Record 


000001 


000002 


000004 
000010 


Record 


000000 
000001 


000002 


000003 
000004 


FBSSEQ 
FBSREL 


FBSIDX 


handling 


FBSFTN 


FBSCR 


FBS PRN 
FBSBLK 


Sequential file 
organization 

Relative file 
organization 

Indexed file organization 


mask 


FORTRAN-style 
carriage-control 
character in record 

Add CRLF to print record 
(LF-record-CR) 

VFC print record handling 
Blocked records 


format code 


FBSUDF 
FBSFIX 


FBSVAR 


FBSVFC 
FBSSTM 


Undefined record format 
Fixed-length record 
format 

Variable-length record 
format 

VFC record format 
Stream record format 
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Table 6-3 (Cont.): FAB Summary 


Offset Field 


Offset Symbol Size Description 
030 OSXAB 1 word XAB address 
032 OSBPA 1 word Private buffer pool address 
034 OSBPS 1 word Private buffer pool size (bytes) 
036 OSMRS 1 word Maximum record size (bytes) 
040 OSMRN 2 words Maximum record number 
044 OSLRL 1 word Longest record length 
046 OSNAM 1 word NAM block address 
050 OSFNA 1 word File string address 
052 OSDNA 1 word Default string address 
054 OSENS l byte File string size (bytes) 
055 OSDNS 1 byte Default string size (bytes) 
056 OSBLS 1 word Magtape block size (characters) 
060 OSFSZ 1 byte Fixed control area size for VFC records 
(bytes) 
061 OSBKS 1 byte File bucket size (blocks) 
062 OSDEV 1 byte Device characteristic mask 


000001 FBSREC Record-oriented device 
000002 FBSCCL Carriage-control device 
000004 FBSTRM Terminal device 

000010 FBSMDI Multidirectory device 
000020 FBSSDI Single-directory device 
000040 FBSSQD Sequential device 


063 OSLCH 1 byte Logical channel number 
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CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.1 ALQ Field in FAB 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


OUTPUT 


Contains the allocation size for the file. 
FSALQ number 
2 words 


SFETCH dst,ALQ,reg *ALQ field to 2-word dst 
SSTORE src,ALQ,reg ;2-word src to ALQ field 
SFETCH dst,ALQn,reg s;ALQ word n to l-word dst 
SSTORE src,ALQn,reg ;l-word sre to ALQ word n 
SCOMPARE src,ALQn,reg j;l-word src with ALQ word n 


CREATE Initial file allocation request size (blocks) 
EXTEND File allocation extension request size 
(blocks) 


CREATE Initial file allocation size (blocks) 
EXTEND File allocation extension actual size (blocks) 
OPEN Current file allocation (blocks) 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.2 BID Field in FAB (FBSBID Code) 


USE Contains the identifier for the FAB. 

INIT None 

SIZE 1 byte 

ACCESS SFETCH dst,BID,reg ;BID field to l-byte dst 


SCOMPARE src,BID,reg ;l-byte sre with BID field 
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CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.3 BKS Field in FAB 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


OUTPUT 


Contains the bucket size for the file. 


FSBKS number 


1 byte 

SFETCH dst,BKS,reg ;BKS field to l-byte dst 
SSTORE src,BKS,reg ;l-byte src to BKS field 
SCOMPARE src,BKS,reg ;l-byte sre with BKS field 
CREATE File bucket size (blocks) 

OPEN File bucket size (blocks) 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.4 BLN Field in FAB (FBSBLN Code) 


USE Contains the length of the FAB. 

INIT None 

SIZE 1 byte 

ACCESS SFETCH dst,BLN,reg ;BLN field to l-byte dst 


SCOMPARE src,BLN,reg ;l-byte src with BLN field 


6.3.5 


USE 
INIT 
SIZE 


ACCESS 


INPUT 


OUTPUT 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


BLS Field in FAB 


Contains the magtape block size for the file. 


FSBLS number 


1 word 

SFETCH dst,BLS,reg ;BLS field to l-word dst 
SSTORE src,BLS,reg ;l-word src to BLS field 
SCOMPARE src,BLS,reg ;l-word sre with BLS field 
CREATE Magtape block size (characters) 

OPEN Magtape block size (characters) 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.6 BPA Field in FAB 
USE Contains the address of the private buffer pool for the 
operation. 
INIT FSBPA address 
SIZE 1 word 
ACCESS SFETCH dst,BPA,reg *;BPA field to l-word dst 
SSTORE src,BPA,reg :l-word src to BPA field 
SCOMPARE src,BPA,reg ;l-word sre with BPA field 
INPUT CREATE Private buffer pool address 
ENTER Private buffer pool address 
ERASE Private buffer pool address 
OPEN Private buffer pool address 
PARSE Private buffer pool address 
REMOVE Private buffer pool address 
RENAME Private buffer pool address 
SEARCH Private buffer pool address 
OUTPUT CLOSE Private buffer pool address 


6.3.7 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


OUTPUT 


BPS Field in FAB 


Contains the size of 
operation. 


FSBPS number 


1 word 


SFETCH dst,BPS,reg 
SSTORE src,BPS,reg 


SCOMPARE src,BPS,reg 


CREATE 
ENTER 
ERASE 
OPEN 
PARSE 
REMOVE 
RENAME 
SEARCH 


CLOSE 


Private 
Private 
Private 
Private 
Private 
Private 
Private 
Private 


Private 


the 


private 


CONTROL BLOCK FIELDS 
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buffer 


pool 


;BPS field to l-word dst 
:;l-word src to BPS field 


sl-word src with BPS field 


buffer 
buffer 
buffer 
buffer 
buffer 
buffer 
buffer 
buffer 


buffer 


pool 
pool 
pool 
pool 
pool 
pool 
pool 
pool 


pool 


size 
size 
size 
size 
size 
size 
size 
size 


size 


(bytes) 
(bytes) 
(bytes) 
(bytes) 
(bytes) 
(bytes) 
(bytes) 
(bytes) 


(bytes) 


for 


the 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.8 CTX Field in FAB 


USE Contains any information you may want to associate with 
the file at run time. 


INIT FSCTX number 

SIZE l word 

ACCESS SFETCH dst,CTX,reg ;CTX field to l-word dst 
SSTORE src,CTX,reg ;l-word sre to CTX field 


SCOMPARE src,CTX,reg ;l-word sre with CTX field 


6.3.9 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


OUTPUT 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


DEQ Field in FAB 


Contains the default extension size for the file. 


FSDEQ number 


1 word 

SFETCH dst,DEQ,reg s;DEQ field to l-word dst 

SSTORE src,DEQ,reg s:l-word src to DEQ field 

SCOMPARE src,DEQ,reg ;l-word sre with DEQ field 

CREATE Permanent file default extension size (blocks) 

OPEN While-open file default extension size 
(blocks) 

OPEN Current file default extension size (blocks) 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.10 DEV Field in FAB 
USE Indicates device characteristics for the file. 
INIT None 
SIZE 1 byte 
ACCESS STESTBITS mask,DEV,reg ;Test mask bits in DEV field 
SFETCH dst,DEV,reg ;DEV field to l-byte dst 
SCOMPARE src,DEV,reg ;l-byte src with DEV field 
MASKS FBSCCL Carriage-control device 
FBSMDI Multidirectory device 
FBSREC Record-oriented device 
FBSSDI Single-directory device 
FBSSQD Sequential device 
FBSTRM Terminal device 
OUTPUT CREATE Device characteristic mask 
ENTER Device characteristic mask 
ERASE Device characteristic mask 
OPEN Device characteristic mask 
PARSE Device characteristic mask 
REMOVE Device characteristic mask 
RENAME Device characteristic mask 
SEARCH Device characteristic mask 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.11 DNA Field in FAB 
USE Contains the address of the default string for the 
operation. 
INIT FSDNA address 
SIZE 1 word 
ACCESS SFETCH dst,DNA,reg sDNA field to l-word dst 
SSTORE src,DNA,reg :;l-word sre to DNA field 
SCOMPARE src,DNA,reg 3;l-word sre with DNA field 
INPUT CREATE Default string address 
ENTER Default string address 
ERASE Default string address 
OPEN Default string address 
PARSE Default string address 
REMOVE Default string address 
RENAME Default string address 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.12 DNS Field in FAB 
USE Contains the size of the default string for the operation. 
INIT FSDNS number 
SIZE 1 byte 
ACCESS SFETCH dst,DNS,reg ;DNS field to l-byte dst 
SSTORE src,DNS,reg ;l-byte src to DNS field 
SCOMPARE src,DNS,reg ;l-byte src with DNS field 
INPUT CREATE Default string size (bytes) 
ENTER Default string size (bytes) 
ERASE Default string size (bytes) 
OPEN Default string size (bytes) 
PARSE Default string size (bytes) 
REMOVE Default string size (bytes) 
RENAME Default string size (bytes) 


6.3.13 


USE 


INIT 


SIZE 


ACCESS 


MASKS 


INPUT 


FAC Field in FAB 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


Indicates the requested access for the file. 


FSFAC mask 


1 byte 


SSET mask,FAC,reg 
SOFF mask,FAC,reg 


sMask bits on in FAC field 
;Mask bits off in FAC field 


STESTBITS mask,FAC,reg ;Test mask bits in FAC field 


SFETCH dst,FAC,reg 
SSTORE src,FAC,reg 
SCOMPARE src,FAC,reg 


FBSDEL 
FBSGET 
FBSPUT 
FBSREA 
FBSTRN 
FBSUPD 
FBSWRT 


CREATE 
OPEN 


Request 
Request 
Request 
Request 
Request 
Request 
Request 


;FAC field to l-byte dst 
;l-byte src to FAC field 
;l-byte src with FAC field 


find/get/delete access 
find/get access 

put access 

block read access 
find/get/truncate access 
find/get/update access 
block write access 


Requested access mask 
Requested access mask 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.14 FNA Field in FAB 


USE Contains the address of the file string for the file. 
INIT FSFNA address 
SIZE l word 
ACCESS SFETCH dst,FNA,reg ;FNA field to l-word dst 
SSTORE src,FNA,reg ;l-word sre to FNA field 
SCOMPARE src,FNA,reg :l-word sre with FNA field 
INPUT CREATE File string address 
ENTER File string address 
ERASE File string address 
OPEN File string address 
PARSE File string address 
REMOVE File string address 
RENAME File string address 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.15 FNS Field in FAB 


USE Contains the size of the file string for the file. 
INIT FSFNS number 
SIZE 1 byte 
ACCESS SFETCH dst,FNS,reg ;FNS field to l-byte dst 
SSTORE src,FNS,reg ;l-byte src to FNS field 
SCOMPARE src,FNS,reg ;l-byte src with FNS field 
INPUT CREATE File string size (bytes) 
ENTER File string size (bytes) 
ERASE File string size (bytes) 
OPEN File string size (bytes) 
PARSE File string size (bytes) 
REMOVE File string size (bytes) 
RENAME File string size (bytes) 
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CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.16 FOP Field in FAB (FBSCTG Mask) 


USE Indicates file contiguity. 

INIT FSFOP mask 

SIZE 1 word 

ACCESS SSET mask,FOP,reg ;Mask bits on in FOP field 
SOFF mask,FOP,reg ;Mask bits off in FOP field 
STESTBITS mask,FOP,reg ;Test mask bits in FOP field 
SFETCH dst,FOP,reg ;FOP field to l-word dst 
SSTORE src,FOP,reg ;l-word src to FOP field 
SCOMPARE src,FOP,reg sl-word src with FOP field 

INPUT CREATE Contiguous file request 
EXTEND Contiguous file extension request 

OUTPUT OPEN Contiguous file 


6.3.17 


USE 
INIT 
SIZE 


ACCESS 


INPUT 


FOP Field in FAB (FBSDFW Mask) 


Requests deferred writing for the 


FSFOP mask 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


file. 


1 word 

SSET mask,FOP,reg sMask bits on in FOP field 
SOFF mask,FOP,reg ;Mask bits off in FOP field 
STESTBITS mask,FOP,reg ;Test mask bits in FOP field 
SFETCH dst,FOP,reg ;FOP field to l-word dst 
SSTORE src,FOP,reg :l-word src to FOP field 
SCOMPARE src,FOP,reg sl-word sre with FOP field 
CREATE Defer writing 

OPEN Defer writing 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.18 


USE 
INIT 
SIZE 


ACCESS 


INPUT 


FOP Field in FAB (FBSDLK Mask) 


Requests no file locking if the file is closed abnormally. 


FSFOP mask 


1 word 

SSET mask,FOP,reg *Mask bits on in FOP field 
SOFF mask,FOP,reg ;Mask bits off in FOP field 
STESTBITS mask,FOP,reg ;Test mask bits in FOP field 
SFETCH dst,FOP,reg ;FOP field to l-word dst 
SSTORE src,FOP,reg s;l-word sre to FOP field 


SCOMPARE src,FOP,reg »l-word 


CREATE No file locking on 
OPEN No file locking on 


sre with FOP field 


abnormal close 
abnormal close 


6.3.19 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


FOP Field in FAB (FBSFID Mask) 


Requests that NAM block information be used to identify 


the file. 

FSFOP mask 

1 word 

SSET mask,FOP,reg *Mask bits on in FOP field 
SOFF mask,FOP,reg ;Mask bits off in FOP field 
STESTBITS mask,FOP,reg ;Test mask bits in FOP field 
SFETCH dst,FOP,reg ;FOP field to l-word dst 
SSTORE src,FOP,reg sl-word sre to FOP field 
SCOMPARE src,FOP,reg s;l-word src with FOP field 
CREATE Use information in NAM block 

ENTER Use information in NAM block 

ERASE Use information in NAM block 

OPEN Use information in NAM block 

REMOVE Use information in NAM block 

RENAME Use information in NAM block 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.20 FOP Field in FAB (FBSMKD Mask) 


USE Requests that the file be marked for deletion. 

INIT FSFOP mask 

SIZE l word 

ACCESS SSET mask,FOP,reg sMask bits on in FOP field 
SOFF mask,FOP,reg ;Mask bits off in FOP field 
STESTBITS mask,FOP,reg ;Test mask bits in FOP field 
SFETCH dst,FOP,reg ;FOP field to l-word dst 
SSTORE src,FOP,reg s;l-word sre to FOP field 


SCOMPARE src,FOP,reg sl-word sre with FOP field 


INPUT CREATE Mark file for deletion 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.21 FOP Field in FAB (FBSNEF Mask) 


USE Requests that the magtape file be positioned to. the 
beginning of the file. 

INIT FSFOP mask 

SIZE l word 

ACCESS SSET mask,FOP,reg sMask bits on in FOP field 
SOFF mask,FOP,reg ;Mask bits off in FOP field 
STESTBITS mask,FOP,reg ;Test mask bits in FOP field 
SFETCH dst,FOP,reg ;FOP field to l-word dst 
SSTORE src,FOP,reg sl-word sre to FOP field 


SCOMPARE src,FOP,reg sl-word src with FOP field 


INPUT OPEN No end-of-file magtape positioning 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.22 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


FOP Field in FAB (FBSPOS Mask) 


Requests that the magtape be positioned to the end of 
last-closed file before creating the new file. 


FSFOP mask 


1 word 

SSET mask,FOP,reg sMask bits on in FOP field 
SOFF mask,FOP,reg ;Mask bits off in FOP field 
STESTBITS mask,FOP,reg ;Test mask bits in FOP field 
SFETCH dst,FOP,reg ;FOP field to l-word dst 
SSTORE src,FOP,reg ;l-word src to FOP field 


SCOMPARE src,FOP,reg :l-word sre with FOP field 


CREATE Position magtape after last-closed file 


the 


6.3.23 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


FOP Field in FAB (FBSRWC Mask) 


Requests that the magtape be rewound when the file is 
closed. 


FSFOP mask 

1 word 

SSET mask,FOP,reg ;Mask bits on in FOP field 
SOFF mask,FOP,reg sMask bits off in FOP field 
STESTBITS mask,FOP,reg ;Test mask bits in FOP field 
SFETCH dst,FOP,reg ;FOP field to l-word dst 
SSTORE src,FOP,reg ;l-word sre to FOP field 
SCOMPARE src,FOP,reg :;l-word sre with FOP field 
CLOSE Rewind magtape after closing file 
CREATE Rewind magtape after closing file 

OPEN Rewind magtape after closing file 
SEARCH Rewind magtape after closing file 


CONTROL BLOCK FIELDS 


FAB SUMMARY 


6.3.24 FOP 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


Field in FAB (FBSRWO Mask) 


Requests that the magtape be rewound before the operation. 


FSFOP mask 


1 word 

SSET mask,FOP,reg ;Mask bits on in FOP field 
SOFF mask,FOP,reg ;Mask bits off in FOP field 
STESTBITS mask,FOP,reg ;Test mask bits in FOP field 
SFETCH dst,FOP,reg ;FOP field to l-word dst 
SSTORE src,FOP,reg ;l-word sre to FOP field 
SCOMPARE src,FOP,reg :l-word sre with FOP field 
CREATE Rewind magtape before creating file 

OPEN Rewind magtape before searching for file 
SEARCH Rewind magtape before operation 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.25 FOP Field in FAB (FBSSUP Mask) 


USE Requests that the created file supersede the old file with 
the same specification (if one exists). 

INIT FSFOP mask 

SIZE 1 word 

ACCESS SSET mask,FOP,reg ;Mask bits on in FOP field 
SOFF mask,FOP,reg ;Mask bits off in FOP field 
STESTBITS mask,FOP,reg ;Test mask bits in FOP field 
SFETCH dst,FOP,reg ;FOP field to l-word dst 
SSTORE src,FOP,reg :l-word src to FOP field 


SCOMPARE src,FOP,reg sl-word sre with FOP field 


INPUT CREATE Supersede existing file 


CONTROL BLOCK FIELDS 


FAB SUMMARY 


6.3.26 FOP 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


Field in FAB (FBSTMP Mask) 


Requests that the created file be a temporary file 
with no directory entry). 


FSFOP mask 

1 word 

SSET mask,FOP,reg sMask bits on in FOP field 
SOFF mask,FOP,reg s;Mask bits off in FOP field 
STESTBITS mask,FOP,reg ;Test mask bits in FOP field 
SFETCH dst,FOP,reg ;FOP field to l-word dst 
SSTORE src,FOP,reg :l-word sre to FOP field 


SCOMPARE src,FOP,reg :;l-word sre with FOP field 


CREATE Temporary file 


(one 


6.3.27 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


OUTPUT 


FSZ Field in FAB 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


Contains the size of the fixed control area for VFC 

records. 

FSFSZ number 

l byte 

SFETCH dst,FSZ,reg ;FSZ field to l-byte dst 

SSTORE src,FSZ,reg ;l-byte src to FSZ field 

SCOMPARE src,FSZ,reg ;l-byte src with FSZ field 

CREATE Fixed control area size for VEC records 
(bytes) 

OPEN Fixed control area size for VEC records 
(bytes) 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.28 IFI Field in FAB 
USE Contains the internal file identifier for the file. 
INIT None 
SIZE 1 word 
ACCESS SFETCH dst,IFI,reg s;IFI field to l-word dst 
SCOMPARE src,IFI,reg sl-word sre with IFI field 
INPUT CLOSE Internal file identifier 
CONNECT Internal file identifier 
DISPLAY Internal file identifier 
EXTEND Internal file identifier 
OUTPUT CLOSE Internal file identifier 
CREATE Internal file identifier 
OPEN Internal file identifier 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.29 LCH Field in FAB 


USE Contains the logical channel number for the operation. 
INIT FSLCH number 
SIZE 1 byte 
ACCESS SFETCH dst,LCH,reg ;LCH field to l-byte dst 
SSTORE src,LCH,reg ;l-byte src to LCH field 
SCOMPARE src,LCH,reg ;l-byte src with LCH field 
INPUT CREATE Logical channel number 
ENTER Logical channel number 
ERASE Logical channel number 
OPEN Logical channel number 
PARSE Logical channel number 
REMOVE Logical channel number 
RENAME Logical channel number 
SEARCH Logical channel number 


CONTROL BLOCK FIELDS 


FAB SUMMARY 


6.3.30 LRL 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


OUTPUT 


Field in FAB 


Contains the length of the longest record in a_ sequential 


file. 
None 
1 word 


SFETCH dst,LRL,reg ;LRL field to l-word dst 
SCOMPARE src,LRL,reg ;l-word sre with LRL field 


CREATE Longest record length (block access 
sequential files only) 


OPEN Longest record length 


to 


6.3.31 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


OUTPUT 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


MRN Field in FAB 


Contains the maximum record number allowed in a relative 
file. 


FSMRN number 


2 words 

SFETCH dst,MRN,reg s;MRN field to 2-word dst 
SSTORE src,MRN,reg ;2-word src to MRN field 
SFETCH dst,MRNn,reg s;MRN word n to l-word dst 
SSTORE src,MRNn,reg sl-word src to MRN word n 
SCOMPARE src,MRNn,reg ;l-word src with MRN word n 
CREATE Maximum record number 

OPEN Maximum record number 


CONTROL BLOCK FIELDS 


FAB SUMMARY 


6.3.32 MRS 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


OUTPUT 


Field in FAB 


Contains the record size for fixed-length records or 
maximum record size for other format records for the file. 


FSMRS number 


1 word 

SFETCH dst,MRS,reg sMRS field to l-word dst 
SSTORE src,MRS,reg ;l-word sre to MRS field 
SCOMPARE src,MRS,reg s;l-word sre with MRS field 
CREATE Maximum record size (bytes) 

OPEN Maximum record size (bytes) 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.33 NAM Field in FAB 


USE Contains the address of the NAM block for the operation. 
INIT FSNAM address 
SIZE 1 word 
ACCESS SFETCH dst,NAM,reg s;NAM field to l-word dst 
SSTORE src,NAM,reg ;l-word src to NAM field 
SCOMPARE src,NAM,reg sl-word sre with NAM field 
INPUT CREATE NAM block address 
ENTER NAM block address 
ERASE NAM block address 
OPEN NAM block address 
PARSE NAM block address 
REMOVE NAM block address 
RENAME NAM block address 
SEARCH NAM block address 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.34 


USE 
INIT 
SIZE 


ACCESS 


CODES 


INPUT 


OUTPUT 


ORG Field in FAB 


Contains the file organization code. 


FSORG code 


1 byte 


SFETCH dst,ORG,reg 
SSTORE src,ORG,reg 
SCOMPARE src,ORG,reg 


FBSIDX 
FBSREL 
FBSSEQ 
CREATE 


OPEN 


;ORG field to l-byte dst 
;l-byte src to ORG field 
;l-byte src with ORG field 


Indexed file organization 
Relative file organization 
Sequential file organization 


File organization code 


File organization code 


6.3.35 


USE 


INIT 


SIZE 


ACCESS 


MASKS 


INPUT 


OUTPUT 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


RAT Field in FAB 


Indicates the record-output characteristic for the file. 
(The RAT field also contains the record-blocking 
characteristic, which is described in the next section.) 


FSRAT mask 

1 byte 

SSET mask,RAT,reg *Mask bits on in RAT field 
SOFF mask,RAT,reg ;Mask bits off in RAT field 
STESTBITS mask,RAT,reg ;Test mask bits in RAT field 
SFETCH dst,RAT,reg ;RAT field to 1l-byte dst 
SSTORE src,RAT,reg ;l-byte src to RAT field 


SCOMPARE src,RAT,reg ;l-byte src with RAT field 

FBSCR Add CRLF to print record (LF-record-CR) 

FBSFTN FORTRAN-Style carriage-control character in record 
FBSPRN VFC print record handling 

CREATE Record handling mask 


OPEN Record handling mask 


CONTROL BLOCK FIELDS 


FAB SUMMARY 


6.3.36 RAT 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


OUTPUT 


Field in FAB (FBSBLK Mask) 


Indicates whether the file has blocked records. (The RAT 
field also contains the record-output characteristic, 
which is described in the previous section.) 


FSRAT mask 


1 byte 

SSET mask,RAT,reg ;Mask bits on in RAT field 
SOFF mask,RAT,reg ;Mask bits off in RAT field 
STESTBITS mask,RAT,reg ;Test mask bits in RAT field 
SFETCH dst,RAT,reg ;RAT field to l-byte dst 
SSTORE src,RAT,reg ;l-byte src to RAT field 
SCOMPARE src,RAT,reg sl-byte src with RAT field 
CREATE Blocked records 

OPEN Blocked records 


6.3.37 


USE 
INIT 
SIZE 


ACCESS 


CODES 


INPUT 


OUTPUT 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


RFM Field in FAB 


Contains the record format code for the file. 


FSREM code 


1 byte 


SFETCH dst,RFM,reg 
SSTORE src,RFM,reg 
SCOMPARE src,RFM,reg 


FBSFIX 
FBSSTM 
FBSUDF 
FBSVAR 
FBSVFC 


CREATE 


OPEN 


;RFM field to l-byte dst 
;l-byte src to REM field 
;l-byte src with REM field 


Fixed-length record format 
Stream record format 
Undefined record format 
Variable-length record format 
VFC record format 


Record format code 


Record format code 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.38 RTV Field in FAB 


USE Contains the retrieval pointer count for the file. 
INIT FSRTV number 
SIZE 1 byte 
ACCESS SFETCH dst,RTV,reg *RTV field to l-byte dst 
SSTORE src,RTV,reg ;l-byte sre to RTV field 
SCOMPARE src,RTV,reg ;l-byte src with RTV field 
INPUT CREATE Retrieval pointer count 
OPEN Retrieval pointer count 


6.3.39 


USE 


INIT 


SIZE 


ACCESS 


MASKS 


INPUT 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


SHR Field in FAB 


Indicates requested access sharing for the file. 


FSSHR mask 


l byte 


SSET mask,SHR,reg 
SOFF mask,SHR,reg 


s;Mask bits on in SHR field 
;Mask bits off in SHR field 


STESTBITS mask,SHR,reg ;Test mask bits in SHR field 


SFETCH dst,SHR,reg 
SSTORE src,SHR,reg 
SCOMPARE src,SHR,reg 


FBSGET 
FBSNIL 
FBSUPI 
FBSWRI 


CREATE 
OPEN 


;SHR field to l-byte dst 
;l-byte src to SHR field 
;l-byte src with SHR field 


Share find/get access 

No access sharing 

Share any access (user-provided interlock) 
Share find/get/put/update/delete access 


Shared access mask 
Shared access mask 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.40 STS Field in FAB 


USE Contains the completion status code for the operation. 
INIT None 
SIZE 1 word 
ACCESS SFETCH dst,STS,reg *STS field to l-word dst 
SCOMPARE src,STS,reg s:l-word sre with STS field 
OUTPUT CLOSE Completion status code 
CREATE Completion status code 
DISPLAY Completion status code 
ENTER Completion status code 
ERASE Completion status code 
EXTEND Completion status code 
OPEN Completion status code 
PARSE Completion status code 
REMOVE Completion status code 
RENAME Completion status code 
SEARCH Completion status code 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.41 STV Field in FAB 


USE Contains the completion status value for the operation. 
INIT None 
SIZE 1 word 
ACCESS SFETCH dst,STV,reg :STV field to l-word dst 
SCOMPARE src,STV,reg s;l-word src with STV field 
OUTPUT CLOSE Completion status value 
CREATE Completion status value 
DISPLAY Completion status value 
ENTER Completion status value 
ERASE Completion status value 
EXTEND Completion status value 
OPEN Completion status value 
PARSE Completion status value 
REMOVE Completion status value 
RENAME Completion status value 
SEARCH Completion status value 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.42 


USE 


INIT 
SIZE 


ACCESS 


INPOT 


XAB Field in FAB 


Contains the address of the first XAB (ALL, DAT, 
) in a chain of XABs. 


or SUM block 
FSXAB addres 


1 word 


SFETCH dst,XAB,reg 
SSTORE src,XAB,reg 


Ss 


*XAB field to l-word dst 
:l-word sre to XAB field 


SCOMPARE src,XAB,reg ;l-word sre with XAB field 


CLOSE 
CREATE 
DISPLAY 
EXTEND 
OPEN 


XAB 
XAB 
XAB 
XAB 
XAB 


address 
address 
address 
address 
address 


KEY, 


PRO, 


CONTROL BLOCK FIELDS 
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6.4 KEY BLOCK SUMMARY 


This section summarizes the KEY block and its fields. Table 6-4 
summarizes the entire block, giving the offset, offset symbol, size, 
and a brief description for each field; for a field that has mask or 
code symbols, the table also gives the value, symbol, and a brief 
description for each mask or code. 


Table 6-4: KEY Block Summary 


Offset Field 
Offset Symbol Size Description 


000 OSCOD 1 byte KEY block identifier code 
000001 XBSKEY KEY block identifier 
001 OSBLN 1 byte KEY block length (bytes) 
000070 xXBSKYL KEY block length (bytes) 
002 OSNXT 1 word Next XAB address 
004 OSREF : byte Index reference number 


005 OSLVL byte Number of index levels (not including 
data level) 


006 OSIFL 1 word Index bucket fill factor 

010 OSDFL 1 word Data bucket fill factor 

012 OSNUL 1 byte Null key character 

013 OSIAN 1 byte Higher level index area number 
014 OSLAN 1 byte Lowest index level area number 
015 OSDAN 1 byte Data area number 

016 OSFLG 1 byte Index option mask 


000001 XBSDUP Duplicate record keys 
allowed 

000002 xXBSCHG Record key changes 
allowed on update 

000020 XBSINI No entries yet made in 
index 

000004 XBSNUL Null record keys not 
indexed 


017 OSDTP 1 byte Key data type code 


000000 XBSSTG String 

000001 xXBSIN2 15-bit signed integer 
000002 XBSBN2 16-bit unsigned integer 
000003 XBSIN4 31-bit signed integer 
000004 XBSBN4 32-bit unsigned integer 
000005 XBSPAC Packed decimal number 


(Continued on next page) 


CONTROL BLOCK FIELDS 
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Table 6-4 (Cont.): KEY Block Summary 


ee 


Offset Field 


Offset Symbol Size Description 

020 OSKNM 1 word Key name buffer address 

022 OSPOS 8 words Key segment positions 

022 OSPOSO 1 word Key segment 0 position 

024 OSPOS1 1 word Key segment 1 position 

026 OSPOS2 1 word Key segment 2 position 

030 OSPO0S3 1 word Key segment 3 position 

032 OSPOS4 1 word Key segment 4 position 

034 OSPOS5 1 word Key segment 5 position 

036 OSPOS6 1 word Key segment 6 position 

040 OSPOS7 1 word Key segment 7 position 

042 OSSIZ 8 bytes Key segment sizes (bytes) 

042 OSSIZO 1 byte Key segment 0 size (bytes) 

043 OSSIZ1 1 byte Key segment 1 size (bytes) 

044 OSSIZ2 1 byte Key segment 2 size (bytes) 

045 OSSIZ3 1 byte Key segment 3 size (bytes) 

046 OSSIZ4 1 byte Key segment 4 size (bytes) 

047 OSSIZ5 1 byte Key segment 5 size (bytes) 

050 OSSIZ6 1 byte Key segment 6 size (bytes) 

051 OSSIZ7 1 byte Key segment 7 size (bytes) 

052 OSRVB 2 words Root index bucket virtual block number 

056 OSDVB 2 words First data bucket virtual block number 

062 OSIBS 1 byte Index area bucket size (blocks) 

063 OSDBS l byte Data area bucket size (blocks) 

064 OSNSG 1 byte Key segment count 

065 OSTKS 1 byte Total key size (sum of key segment sizes) 
(bytes) 

066 OSMRL 1 word Minimum length of record containing key 
(bytes) 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


6.4.1 BLN Field in KEY Block (XBSKYL Code) 


USE Contains the length of the KEY block. 

INIT None 

SIZE 1 byte 

ACCESS SFETCH dst,BLN,reg s;BLN field to l-byte dst 


SCOMPARE src,BLN,reg ;l-byte src with BLN field 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


6.4.2 COD Field in KEY Block (XBSKEY Code) 


USE Contains the identifier for the KEY block. 

INIT None 

SIZE 1 byte 

ACCESS SFETCH dst,COD,reg ;COD field to l-byte dst 


SCOMPARE src,COD,reg ;l-byte src with COD field 


6.4.3 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


OUTPUT 


CONTROL BLOCK FIELDS 
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DAN Field in KEY Block 


Contains the area number of the data area for the index 
described by the KEY block. 


XSDAN number 


1 byte 

SFETCH dst,DAN,reg ;DAN field to l-byte dst 
SSTORE src,DAN,reg ;l-byte src to DAN field 
SCOMPARE src,DAN,reg ;l-byte src with DAN field 
CREATE Data area number 

DISPLAY Data area number 

OPEN Data area number 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


6.4.4 


USE 


INIT 


SIZE 


ACCESS 


OUTPUT 


DBS Field in KEY Block 


Contains the bucket size for the data area for the 
described by the KEY block. 


None 

1 byte 

SFETCH dst,DBS,reg ;DBS field to l-byte dst 
SCOMPARE src,DBS,reg ;l-byte src with DBS field 
DISPLAY Data area bucket size (blocks) 

OPEN Data area bucket size (blocks) 


index 


6.4.5 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


OUTPUT 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


DFL Field in KEY Block 


Contains the bucket fill number for the data area for the 
index described by the KEY block. 


XSDFL number 


1 word 

SFETCH dst,DFL,reg ;DFL field to l-word dst 
SSTORE src,DFL,reg sl-word sre to DFL field 
SCOMPARE src,DFL,reg s;l-word sre with DFL field 
CREATE Data bucket fill factor 

DISPLAY Data bucket fill factor 

OPEN Data bucket fill factor 


CONTROL BLOCK FIELDS 
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6.4.6 


USE 


INIT 
SIZE 


ACCESS 


CODES 


INPUT 


OUTPUT 


DTP Field in KEY Block 


Contains the key data type code for the index described 
the KEY block. 


XSDTP code 


1 byte 
SFETCH dst,DTP,reg ;DTP field to l-byte dst 
SSTORE src,DTP,reg ;l-byte src to DTP field 


SCOMPARE src,DTP,reg ;l-byte sre with DTP field 


XBSBN2 16-bit unsigned integer 
XBSBN4 32-bit unsigned integer 
XBSIN2 15-bit signed integer 
XBSIN4 31-bit signed integer 
XBSPAC Packed decimal number 
XBSSTG String 


CREATE Key data type code 
DISPLAY Key data type code 
OPEN Key data type code 


by 
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6.4.7 DVB Field in KEY Block 


USE 


INIT 
SIZE 
ACCESS 


OUTPUT 


Contains the virtual block number of the first bucket in 
the data area for the index described by the KEY block. 


None 

2 words 

SFETCH dst,DVB,reg sDVB field to 2-word dst 
DISPLAY First data bucket virtual block number 
OPEN First data bucket virtual block number 


CONTROL BLOCK FIELDS 
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6.4.8 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


OUTPUT 


FLG Field in KEY Block (XBSCHG Mask) 


Specifies that a record key (for an alternate index) is 
allowed to change when the record is updated. 


XSFLG mask 


1 byte 

SSET mask,FLG,reg ;Mask bits on in FLG field 
SOFF mask,FLG,reg sMask bits off in FLG field 
STESTBITS mask,FLG,reg ;Test mask bits in FLG field 
SFETCH dst,FLG,reg ;FLG field to l-byte dst 
SSTORE src,FLG,reg ;l-byte src to FLG field 
SCOMPARE src,FLG,reg ;l-byte sre with FLG field 
CREATE Record key changes allowed on update 
DISPLAY Record key changes allowed on update 
OPEN Record key changes allowed on update 


6.4.9 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


OUTPUT 


CONTROL BLOCK FIELDS 
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FLG Field in KEY Block (XBSDUP Mask) 


Indicates that duplicate record keys are allowed for the 
index described by the KEY block; duplicate record keys 
are not allowed in the primary index. 


XSFLG mask 


1 byte 

SSET mask,FLG,reg ;Mask bits on in FLG field 
SOFF mask,FLG,reg ;Mask bits off in FLG field 
STESTBITS mask,FLG,reg ;Test mask bits in FLG field 
SFETCH dst,FLG,reg ;FLG field to l-byte dst 
SSTORE src,FLG,reg ;l-byte src to FLG field 
SCOMPARE src,FLG,reg ;l-byte src with FLG field 
CREATE Duplicate record keys allowed 

DISPLAY Duplicate record keys allowed 

OPEN Duplicate record keys allowed 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


6.4.10 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


OUTPUT 


FLG Field in KEY Block (XBSNUL Mask) 


Indicates that records containing only null characters are 
not contained in the index described by the KEY block. 
(The null character is specified in the NUL field of the 
KEY block.) 


XSFLG mask 


1 byte 

SSET mask,FLG,reg sMask bits on in FLG field 
SOFF mask,FLG,reg ;Mask bits off in FLG field 
STESTBITS mask,FLG,reg ;Test mask bits in FLG field 
SFETCH dst,FLG,reg ;FLG field to 1l-byte dst 
SSTORE src,FLG,reg ;l-byte src to FLG field 
SCOMPARE src,FLG,reg ;l-byte src with FLG field 
CREATE Null record keys not indexed 

DISPLAY Null record keys not indexed 

OPEN Null record keys not indexed 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


6.4.11 IAN Field in KEY Block 


USE Contains the area number of the area containing the higher 
index levels (all except the lowest level) for the index 
described by the KEY block. 


INIT XSIAN number 

SIZE 1 byte 

ACCESS SFETCH dst,IAN,reg ;IAN field to l-byte dst 
SSTORE src,IAN,reg ;l-byte sre to IAN field 
SCOMPARE src,IAN,reg ;l-byte src with IAN field 

INPUT CREATE Higher level index area number 

OUTPUT DISPLAY Higher level index area number 
OPEN Higher level index area number 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


6.4.12 


USE 


INIT 
SIZE 


ACCESS 


OUTPUT 


IBS Field in KEY Block 


Contains the bucket size of the area containing the 
described by the KEY block. 


None 

1 byte 

SFETCH dst,IBS,reg ;IBS field to l-byte dst 
SCOMPARE src,IBS,reg ;l-byte src with IBS field 
DISPLAY Index area bucket size (blocks) 

OPEN Index area bucket size (blocks) 


index 


6.4.13 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


OUTPUT 
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IFL Field in KEY Block 


Contains the bucket fill number for the area containing 
the index described by the KEY block. 


XSIFL number 


1 word 

SFETCH dst,IFL,reg ;IFL field to l-word dst 
SSTORE src,IFL,reg ;l-word src to IFL field 
SCOMPARE src,IFL,reg s;l-word sre with IFL field 
CREATE Index bucket fill factor 

DISPLAY Index bucket fill factor 

OPEN Index bucket fill factor 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


6.4.14 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


KNM Field in KEY Block 


Contains the address of the 32-byte key name buffer 
the index described by the KEY block. 


XSKNM address 


1 word 

SFETCH dst,KNM,reg ;KNM field to l-word dst 
SSTORE src,KNM,reg ;l-word src to KNM field 
SCOMPARE src,KNM,reg s;l-word src with KNM field 
CREATE Key name buffer address 

DISPLAY Key name buffer address 

OPEN Key name buffer address 


for 


6.4.15 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


OUTPUT 


LAN Field in KEY Block 


CONTROL BLOCK FIELDS 
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Contains the area number of the area containing the lowest 
level of the index described by the KEY block. 


XSLAN number 
1 byte 
SFETCH dst,LAN,reg 


SSTORE src,LAN,reg 
SCOMPARE src,LAN,reg 


CREATE Lowest index level 
DISPLAY Lowest index level 
OPEN Lowest index level 


;LAN field to l-byte dst 


;1l-byte 
;l-byte 


src to LAN field 
sre with LAN field 


area number 


area number 
area number 


CONTROL BLOCK FIELDS 
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6.4.16 LVL Field in KEY Block 


USE Contains the number of levels (not including the data 
level) for the index described by the KEY block. 


INIT None 
SIZE 1 byte 
ACCESS SFETCH dst,LVL,reg ;LVL field to 1l-byte dst 
SCOMPARE src,LVL,reg ;l-byte src with LVL field 
OUTPUT DISPLAY Number of index levels (not including data 
level) 
OPEN Number of index levels (not including data 
level) 


6.4.17 


USE 


INIT 
SIZE 


ACCESS 


OUTPUT 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


MRL Field in KEY Block 


Contains the length of the smallest record that is long 
enough to completely contain a record key for the index 
described by the KEY block. 


None 

1 word 

SFETCH dst,MRL,reg sMRL field to l-word dst 

SCOMPARE src,MRL,reg ;l-word src with MRL field 

DISPLAY Minimum length of record containing key 
(bytes) 

OPEN Minimum length of record containing key 
(bytes) 


CONTROL BLOCK FIELDS 
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6.4.18 


USE 


INIT 
SIZE 


ACCESS 


OUTPUT 


NSG Field in KEY Block 


Contains the number of key segments in the key for 
index described by the KEY block. 


None 

1 byte 

SFETCH dst,NSG,reg ;NSG field to l-byte dst 
SCOMPARE src,NSG,reg ;l-byte src with NSG field 
DISPLAY Key segment count 

OPEN Key segment count 


the 


6.4.19 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


OUTPUT 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


NUL Field in KEY Block 


Contains the null character for the (alternate) index 
described by the KEY block. For a string key (XBSSTG in 
the DTP field of the KEY block), the NUL field contains an 
ASCII character; for any other key data type, the NUL 
field is unused (nonstring keys use 0 as the null value 
when the XBSNUL mask is set). 


XSNUL number 


1 byte 

SFETCH dst,NUL,reg ;NUL field to 1l-byte dst 
SSTORE src,NUL,reg ;l-byte sre to NUL field 
SCOMPARE src,NUL,reg ;l-byte src with NUL field 
CREATE Null key character 

DISPLAY Null key character 

OPEN Null key character 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


6.4.20 NXT Field in KEY Block 


USE Contains the address of the next XAB (ALL, DAT, KEY, PRO, 
or SUM block) in a chain of XABs. 
INIT XSNXT address 
SIZE 1 word 
ACCESS SFETCH dst,NXT,reg sNXT field to l-word dst 
SSTORE src,NXT,reg ;l-word sre to NXT field 
SCOMPARE src,NXT,reg sl-word sre with NXT field 
INPUT CLOSE Next XAB address 
CREATE Next XAB address 
DISPLAY Next XAB address 
ENTER Next XAB address 
ERASE Next XAB address 
EXTEND Next XAB address 
OPEN Next XAB address 
PARSE Next XAB address 
REMOVE Next XAB address 
RENAME Next XAB address 
SEARCH Next XAB address 


CONTROL BLOCK FIELDS 
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6.4.21 POS Field in KEY Block 


USE Contains the positions of segments for the record keys in 
the index described by the KEY block. (The first key 
position is position 0.) 


INIT XSPOS <number[,number]...> 

SIZE 8 words 

ACCESS SFETCH dst,POS,reg ;POS field to 8-word dst 
SSTORE src,POS,reg 78-word src to POS field 
SFETCH dst,POSn,reg *POS word n to l-word dst 
SSTORE src,POSn,reg :;l-word src to POS word n 
SCOMPARE src,POSn,reg ;l-word sre with POS word n 

INPUT CREATE Key segment positions 

OUTPUT DISPLAY Key segment positions 
OPEN Key segment positions 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


6.4.22 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


Contains the reference 


REF Field in KEY Block 


the KEY block. 


XSREF number 


1 byte 


SFETCH dst,REF,reg 
SSTORE src,REF,reg 
SCOMPARE src,REF,reg 


CLOSE 
CREATE 
DISPLAY 
EXTEND 
OPEN 


Index 
Index 
Index 
Index 
Index 


number for the index 


described by 


*REF field to l-byte dst 
;l-byte src to REF field 


reference 
reference 
reference 
reference 
reference 


number 
number 
number 
number 
number 


;l-byte src with REF field 


6.4.23 


USE 


INIT 
SIZE 
ACCESS 


OUTPUT 
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RVB Field in KEY Block 


Contains the virtual block number of the first block of 
the root bucket of the index described by the KEY block. 


None 

2 words 

SFETCH dst,RVB,reg sRVB field to 2-word dst 
DISPLAY Root index bucket virtual block number 
OPEN Root index bucket virtual block number 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


6.4.24 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


OUTPUT 


SIZ Field in KEY Block 


Contains the sizes of segments for the record keys in 
index described by the KEY block. 


XSSIZ <number[,number]...> 


8 bytes 

SFETCH dst,SIZ,reg ;SIZ field to 8-byte dst 
SSTORE src,SIZ,reg ;8-byte sre to SIZ field 
SFETCH dst,SI2Z2n,reg ;SIZ byte n to 1l-byte dst 
SSTORE src,SIZn,reg ;l-byte src to SIZ byte n 
SCOMPARE src,SIZn,reg ;l-byte src with SIZ byte n 
CREATE Key segment sizes (bytes) 

DISPLAY Key segment sizes (bytes) 

OPEN Key segment sizes (bytes) 


6-92 


the 


6.4.25 


USE 


INIT 
SIZE 


ACCESS 


OUTPUT 


CONTROL BLOCK FIELDS 
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TKS Field in KEY Block 


Contains the total key size (sum of the segment sizes) of 
a record key for the index described by the KEY block. 


None 

1 byte 

SFETCH dst,TKS,reg ;TKS field to l-byte dst 

SCOMPARE src,TKS,reg ;l-byte sre with TKS field 

DISPLAY Total key size (sum of key segment’ sizes) 
(bytes) 

OPEN Total key size (sum of key segment’ sizes) 


(bytes) 


CONTROL BLOCK FIELDS 
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6.5 NAM BLOCK SUMMARY 
This section summarizes the NAM block and its fields. Table 6-5 
summarizes the entire block, giving the offset, offset symbol, size, 


for a field that has mask or 
gives the value, symbol, and a brief 


and a brief description for each field; 
code symbols, the table also 
description for each mask or code. 


Table 6-5: NAM Block Summary 


Offset Field 
Offset Symbol Size Description 
000 OSRLF 1 word Reserved 
002 OSRSA 1 word Resultant string buffer address 
004 OSRSS 1 byte Resultant string buffer size (bytes) 
005 OSRSL 1 byte Resultant string length (bytes) 
006 OSDVI 2 words Device identifier 
012 OSWDI 1 word Wildcard directory context 
014 OSFID 3 words File identifier 
022 OSDID 3 words Directory identifier 
030 OSFNB 1 word File specification mask 
00000L NBSVER File version in file 
String or default string 
000002 NBSTYP File type in file string 
or default string 
000004 NBSNAM File name in file string 
or default string 
000010 NBSWVE Wildcard file version in 
file string or default 
string 
000020 NBSWTY Wildcard file type in 
file string or default 
string 
000040 NBSWNA Wildcard file name in 
file string or default 
string 
000100 NBSDIR Directory in file string 
or default string 
000200 NBSDEV Device in file string or 
default string 
000400 NBSNOD Node in file string or 
default string 
001000 NBSWDI Wildcard directory in 
file string or default 
string 
002000 NBSQUO Quoted string in file 
String or default string 
004000 NBSWCH Wildcard context 
established 
032 OSESA 1 word Expanded string buffer address 
034 OSESS l byte Expanded string buffer size (bytes) 
035 OSESL 1 byte Expanded string length (bytes) 
036 OSWCC l word Wildcard context 
The first word of the NAM block is currently reserved, as noted above, 
and must contain the value 0. If the NAM block is extended in the 
future, the first byte will contain an identifier and the second byte 


will contain the 


(new) 


block length. 


CONTROL BLOCK FIELDS 
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6.5.1 DID Field in NAM Block 
USE Contains the directory identifier for the target file. 
INIT None 
SIZE 3 words 
ACCESS SFETCH dst,DID,reg s;DID field to 3-word dst 
INPUT CREATE Directory identifier 
ENTER Directory identifier 
ERASE Directory identifier 
OPEN Directory identifier 
REMOVE Directory identifier 
RENAME Directory identifier 
SEARCH Directory identifier 
OUTPUT CREATE Directory identifier 
ENTER Directory identifier 
ERASE Directory identifier 
OPEN Directory identifier 
PARSE Directory identifier (cleared) 
REMOVE Directory identifier 
RENAME Directory identifier 
SEARCH Directory identifier 


CONTROL BLOCK FIELDS 
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6.5.2 DVI Field in NAM Block 
USE Contains the device identifier for the target file. 
INIT None 
SIZE 2 words 
ACCESS SFETCH dst,DVI,reg ;DVI field to 2-word dst 
INPUT CREATE Device identifier 
ENTER Device identifier 
ERASE Device identifier 
OPEN Device identifier 
REMOVE Device identifier 
RENAME Device identifier 
SEARCH Device identifier 
OUTPUT CREATE Device identifier 
ENTER Device identifier 
ERASE Device identifier 
OPEN Device identifier 
PARSE Device identifier 
REMOVE Device identifier 
RENAME Device identifier 


CONTROL BLOCK FIELDS 
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6.5.3 ESA Field in NAM Block 


USE Contains the address of the expanded string buffer. 
INIT NSESA address 
SIZE 1 word 
ACCESS SFETCH dst,ESA,reg *ESA field to l-word dst 
SSTORE src,ESA,reg ;l-word sre to ESA field 
SCOMPARE src,ESA,reg ;l-word sre with ESA field 
INPUT CREATE Expanded string buffer address 
ENTER Expanded string buffer address 
ERASE Expanded string buffer address 
OPEN Expanded string buffer address 
PARSE Expanded string buffer address 
REMOVE Expanded string buffer address 
RENAME Expanded string buffer address 
SEARCH Expanded string buffer address 


CONTROL BLOCK FIELDS 
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6.5.4 ESL Field in NAM Block 

USE Contains the length of the expanded string. 

INIT None 

SIZE 1 byte 

ACCESS SFETCH dst,ESL,reg ;ESL field to l-byte dst 
SCOMPARE src,ESL,reg ;l-byte sre with ESL field 

INPUT SEARCH Expanded string length (bytes) 

OUTPUT CREATE Expanded string length (bytes) 
ENTER Expanded string length (bytes) 
ERASE Expanded string length (bytes) 
OPEN Expanded string length (bytes) 
PARSE Expanded string length (bytes) 
REMOVE Expanded string length (bytes) 
RENAME Expanded string length (bytes) 


CONTROL BLOCK FIELDS 
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6.5.5 ESS Field in NAM Block 

USE Contains the size of the expanded string buffer. 

INIT NSESS number 

SIZE 1 byte 

ACCESS SFETCH dst,ESS,reg ;ESS field to l-byte dst 
SSTORE src,ESS,reg ;l-byte src to ESS field 
SCOMPARE src,ESS,reg ;l-byte src with ESS field 

INPUT CREATE Expanded string buffer size (bytes) 
ENTER Expanded string buffer size (bytes) 
ERASE Expanded string buffer size (bytes) 
OPEN Expanded string buffer size (bytes) 
PARSE Expanded string buffer size (bytes) 
REMOVE Expanded string buffer size (bytes) 
RENAME Expanded string buffer size (bytes) 


CONTROL BLOCK FIELDS 


NAM BLOCK SUMMARY 


6.5.6 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


OUTPUT 


FID Field in NAM Block 


Contains the file identifier for the target file. 


None 


3 words 


SFETCH dst,FID,reg 


ENTER 
ERASE 
OPEN 
REMOVE 


CREATE 
ERASE 
OPEN 
REMOVE 
RENAME 
SEARCH 


File 
File 
File 
File 


File 
File 
File 
File 
File 
File 


identifier 
identifier 
identifier 
identifier 


identifier 
identifier 
identifier 
identifier 
identifier 
identifier 


6-100 


;FID field to 3-word dst 


(only if FBSFID mask is set) 
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6.5.7  FNB Field in NAM Block 


USE Indicates which parts of the merged string were taken from 
the file string or the default string. (The masks in this 
section do not include the NBSWCH mask, which has its own 
description in the next section.) 


INIT None 

SIZE 1 word 

ACCESS STESTBITS mask,FNB,reg ;Test mask bits in FNB field 
SFETCH dst,FNB,reg ;FNB field to l-word dst 


SCOMPARE src,FNB,reg :1l-word sre with FNB field 


MASKS NBSDEV Device in file string or default string 
NBSDIR Directory in file string or default string 
NBSNAM File name in file string or default string 
NBSNOD Node in file string or default string 
NBSQUO Quoted string in file string or default string 
NBSTYP File type in file string or default string 
NBSVER File version in file string or default string 
NBSWDI Wildcard directory in file string or default 


string 
NBSWNA Wildcard file name in file string or default 
string 
NBSWTY Wildcard file type in file string or default 
string 
NBSWVE Wildcard file version in file string or default 
string 
OUTPUT CREATE File specification mask 
ENTER File specification mask 
ERASE File specification mask 
OPEN File specification mask 
PARSE File specification mask 
REMOVE File specification mask 
RENAME File specification mask 


6-101 
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6.5.8 FNB Field in NAM Block (NBSWCH Mask) 


USE Indicates that a valid wildcard context exists. (Masks 
for the FNB field other than the NBSWCH mask are described 
in the previous section.) 


INIT None 
SIZE 1 word 
ACCESS STESTBITS mask,FNB,reg ;Test mask bits in FNB field 
SFETCH dst,FNB,reg ;FNB field to l-word dst 
SCOMPARE src,FNB,reg ;l-word src with FNB field 
INPUT ERASE Wildcard context established 
OPEN Wildcard context established 
REMOVE Wildcard context established 
RENAME Wildcard context established 
SEARCH Wildcard context established 
OUTPUT CREATE Wildcard context established 
ENTER Wildcard context established 
OPEN Wildcard context established 
PARSE Wildcard context established 
SEARCH Wildcard context established 


6-102 
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6.5.9 RSA Field in NAM Block 


USE Contains the address of the resultant string buffer. 

INIT NSRSA address 

SIZE 1 word 

ACCESS SFETCH dst,RSA,reg ;RSA field to l-word dst 
SSTORE src,RSA,reg ;l-word src to RSA field 


SCOMPARE src,RSA,reg :l-word sre with RSA field 


INPUT SEARCH Resultant string buffer address 


6-103 
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6.5.10 


USE 
INIT 
SIZE 


ACCESS 


INPUT 


OUTPUT 


RSL Field in NAM Block 


Contains the length of the resultant string. 


None 

l byte 

SFETCH dst,RSL,reg ;RSL field to 1l-byte dst 
SCOMPARE src,RSL,reg ;l-byte src with RSL field 
SEARCH Resultant string length (bytes) 
SEARCH Resultant string length (bytes) 


6-104 
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6.5.11 RSS Field in NAM Block 


USE Contains the size of the resultant string buffer. 

INIT NSRSS number 

SIZE 1 byte 

ACCESS SFETCH dst,RSS,reg ;RSS field to l-byte dst 
SSTORE src,RSS,reg ;l-byte src to RSS field 


SCOMPARE src,RSS,reg ;l-byte src with RSS field 


INPUT SEARCH Resultant string buffer size (bytes) 
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6.5.12 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


OUTPUT 


WCC Field in NAM Block 


Contains wildcard context information. 


None 


1 word 


SFETCH dst,WCC,reg 
SCOMPARE src,WCC,reg 


SEARCH 


PARSE 
SEARCH 


Wildcard 


Wildcard 
Wildcard 


;wCC field to l-word dst 
:;l-word sre with WCC field 


context 


context 
context 
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WDI Field in NAM Block 


Contains wildcard directory context information. 


None 

l word 

SFETCH dst,WDI,reg sWDI field to l-word dst 
SCOMPARE src,WDI,reg ;l-word sre with WDI field 
SEARCH Wildcard directory context 

PARSE Wildcard directory context 

SEARCH Wildcard directory context 


6-107 


CONTROL BLOCK FIELDS 
PRO BLOCK SUMMARY 


6.6 PRO BLOCK SUMMARY 


This section summarizes the PRO block and its’ fields. Table 6-6 
summarizes the entire block, giving the offset, offset symbol, size, 
and a brief description for each field; for a field that has mask or 
code symbols, the table also gives the value, symbol, and a brief 
description for each mask or code. 


Table 6-6: PRO Block Summary 


Offset Field 
Offset Symbol Size Description 
000 OSCOD 1 byte PRO block identifier 
000003 XBSPRO PRO block identifier code 
001 OSBLN 1 byte PRO block length (bytes) 
000012 xXBSPRL PRO block length (bytes) 


002 OSNXT 
004 OSPRG 


word Next XAB address 
word Programmer or member portion of file 
owner code 
006 OSPRJ 1 word Project or group portion of file owner 
code 
010 OSPRO 1 word File protection code 


re 
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6.6.1 BLN Field in PRO Block (XBSPRL Code) 


USE Contains the length of the PRO block. 

INIT None 

SIZE l byte 

ACCESS SFETCH dst,BLN,reg ;BLN field to l-byte dst 


SCOMPARE src,BLN,reg ;l-byte src with BLN field 
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6.6.2 COD Field in PRO Block (XBSPRO Code) 


USE Contains the identifier for the PRO block. 

INIT None 

SIZE 1 byte 

ACCESS SFETCH dst,COD,reg s;COD field to l-byte dst 


SCOMPARE src,COD,reg ;l-byte src with COD field 
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6.6.3 NXT Field in PRO Block 


USE Contains the address of the next XAB (ALL, DAT, KEY, PRO, 
or SUM block) in a chain of XABs. 
INIT XSNXT address 
SIZE 1 word 
ACCESS SFETCH dst,NXT,reg s;NXT field to l-word dst 
SSTORE src,NXT,reg ;l-word src to NXT field 
SCOMPARE src,NXT,reg sl-word sre with NXT field 
INPUT CLOSE Next XAB address 
CREATE Next XAB address 
DISPLAY Next XAB address 
ENTER Next XAB address 
ERASE Next XAB address 
EXTEND Next XAB address 
OPEN Next XAB address 
PARSE Next XAB address 
REMOVE Next XAB address 
RENAME Next XAB address 
SEARCH Next XAB address 
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6.6.4 


USE 


INIT 


SIZE 


ACCESS 


INPOT 


OUTPUT 


PRG Field in PRO Block 


Contains the member or 
owner code. 


XSPRG number 
1 word 
SFETCH dst,PRG,reg 


SSTORE src,PRG,reg 
SCOMPARE src,PRG,reg 


CLOSE Programmer 
code 

DISPLAY Programmer 
code 

OPEN Programmer 
code 


programmer portion of the 


PRG field to l-word dst 
;l-word src to PRG field 
;l-word src with PRG field 


or member portion of file 


or member portion of file 


Or member portion of file 
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file 


owner 


owner 


owner 


6.6.5 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


OUTPUT 


CONTROL BLOCK FIELDS 
PRO BLOCK SUMMARY 


PRJ Field in PRO Block 


Contains the group or project portion of the file owner 
code. 


XSPRJ number 


l word 

SFETCH dst,PRJ,reg ;PRJ field to l-word dst 

SSTORE src,PRJ,reg ;l-word sre to PRJ field 
SCOMPARE src,PRJ,reg s;l-word src with PRJ field 

CLOSE Project or group portion of file owner code 
DISPLAY Project or group portion of file owner code 
OPEN Project or group portion of file owner code 
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6.6.6 PRO Field in PRO Block 


USE Contains the protection code for the file. 

INIT XSPRO number 

SIZE 1 word 

ACCESS SFETCH dst,PRO,reg PRO field to l-word dst 
SSTORE src,PRO,reg sl-word sre to PRO field 
SCOMPARE src,PRO,reg sl-word src with PRO field 

INPOT CLOSE File protection code 
CREATE File protection code 

OUTPUT DISPLAY File protection code 
OPEN File protection code 
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6.7 RAB SUMMARY 


This section summarizes the RAB and its fields. Table 6-7 summarizes 


the entire block, giving the offset, offset symbol, size, and a brief 
description for each field; for a field that has mask or _ code 
symbols, the table also gives the value, symbol, and a brief 
description for each mask or code. 
Table 6-7: RAB Summary 
Offset Field 
Offset Symbol Size Description 
000 OSBID 1 byte RAB identifier code 
000001 RBSBID RAB identifier 
001 OSBLN 1 byte RAB length (bytes) 
000120 RBSBLN Synchronous RAB length 
(bytes) 
000240 RBSBLL Asynchronous RAB length 
(bytes) 
002 OSCTX 1 word User context 
004 OSISI 1 word Internal stream identifier 
006 OssTSs 1 word Completion status code 
010 OSSTV 1 word Completion status value 
012 OSRFA 3 words Record file address 
020 OSRAC 1 byte Record access code 
000000 RBSSEQ Sequential access 
000001 RBSKEY Key access 
000002 RBSRFA RFA access 
021 OSKSZ 1 byte Key size (bytes) 
022 OSROP 1 word Record processing option mask 
000001 RBSEOF Position to end-of-file 
000002 RBSMAS Mass insert 
000020 RBSLOA Honor bucket fill numbers 
000100 RBSLOC Locate mode 
000200 RBSASY Asynchronous operation 
002000 RBSKGE Greater-than-or-equal key 
criterion 
004000 RBSKGT Greater-than key 
criterion 
010000 RBSFDL Fast deletion 
020000 RBSUIF Update if record exists 
024 OSUSZ 1 word User buffer size (bytes) 
026 OSUBF 1 word User buffer address 
030 OSRSZ 1 word Record size (bytes) 
032 OSRBF 1 word Record buffer address 
034 OSKBF 1 word Key buffer address 
036 OSKRF 1 byte Key of reference 
037 OSMBF 1 byte Multibuffer count 
040 OSMBC 1 byte Multiblock count 
041 OSRT1A 1 byte Reserved 
042 OSRHB 1 word VFC control buffer address 
044 OSFAB 1 word FAB address 
046 OSBKT 2 words Virtual block number (VBN) or relative 


record number (RRN) 
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6.7.1 BID Field in RAB (RBSBID Code) 


USE Contains the identifier for the RAB. 

INIT None 

SIZE l byte 

ACCESS SFETCH dst,BID,reg ;BID field to l-byte dst 


SCOMPARE src,BID,reg ;l-byte src with BID field 
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6.7.2 BKT Field in RAB 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


OUTPUT 


Contains a virtual block number or relative record number 
for a target record. 


RSBKT number 


2 words 

SFETCH dst,BKT,reg ;BKT field to 2-word dst 
SSTORE src,BKT,reg ;2-word src to BKT field 
SFETCH dst,BkKTn,reg ;BKT word n to l-word dst 
SSTORE src,BKTn,reg ;l-word sre to BKT word n 
SCOMPARE src,BKTn,reg ;l-word src with BRKT word n 
READ Virtual block number (VBN) 

SPACE Virtual block number (VBN) increment 
WRITE Virtual block number (VBN) 

FIND Relative record number (RRN) 

GET Relative record number (RRN) 

PUT Relative record number (RRN) 
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6.7.3 BLN Field in RAB 


USE Contains the length of the RAB. 

INIT None 

SIZE 1 byte 

ACCESS SFETCH dst,BLN,reg ;BLN field to l-byte dst 


SCOMPARE src,BLN,reg ;l-byte src with BLN field 


CODES RBSBLL Asynchronous RAB length (bytes) 
RBSBLN Synchronous RAB length (bytes) 
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6.7.4 CTX Field in RAB 


USE 


INIT 
SIZE 


ACCESS 


Contains any information you may want to associate with 
the stream at run time. 


RSCTX number 


1 word 
SFETCH dst,CTX,reg ;CTX field to l-word dst 
SSTORE src,CTX,reg ;l-word sre to CTX field 


SCOMPARE src,CTX,reg s;l-word sre with CTX field 
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6.7.5 FAB Field in RAB 


USE Contains the address of the FAB for the target file. 

INIT RSFAB address 

SIZE 1 word 

ACCESS SFETCH dst,FAB,reg sFAB field to l-word dst 
SSTORE src,FAB,reg s;l-word sre to FAB field 


SCOMPARE src,FAB,reg :;l-word sre with FAB field 


INPUT CONNECT FAB address 
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USE 
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ACCESS 


INPUT 


OUTPUT 


Field in RAB 


Contains the internal stream 


file. 
None 


1 word 


SFETCH dst,ISI,reg 
SCOMPARE src,ISI,reg 


DELETE 
DISCONNECT 
FIND 
FLUSH 
FREE 

GET 
NXTVOL 
PUT 

READ 
REWIND 
SPACE 
TRUNCATE 
UPDATE 
WAIT 
WRITE 


CONNECT 
DISCONNECT 


Internal 
Internal 
Internal 
Internal 
Internal 
Internal 
Internal 
Internal 
Internal 
Internal 
Internal 
Internal 
Internal 
Internal 
Internal 


Internal 
Internal 


identifi 
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er for the target 


;ISI field to l-word dst 
s;l-word src with ISI field 


stream 
stream 
stream 
stream 
stream 
stream 
stream 
stream 
stream 
stream 
stream 
stream 
stream 
stream 
stream 


stream 
stream 
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identifier 
identifier 
identifier 
identifier 
identifier 
identifier 
identifier 
identifier 
identifier 
identifier 
identifier 
identifier 
identifier 


identifier 
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6.7.7 KBF Field in RAB 


USE Contains the address of the key buffer for the target 
record. 
INIT RSKBF address 
SIZE 1 word 
ACCESS SFETCH dst,KBF,reg ;KBE field to l-word dst 
SSTORE src,KBF,reg ;l-word src to KBF field 
SCOMPARE src,KBF,reg s;l-word sre with KBF field 
INPUT FIND Key buffer address 
GET Key buffer address 
PUT Key buffer address 
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INPOT 
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KRF Field in RAB 


Contains the index reference number of the index for the 
operation. 


RSKRF number 


1 byte 

SFETCH dst,KRF,reg ;KRF field to l-byte dst 
SSTORE src,KRF,reg ;l-byte sre to KRF field 
SCOMPARE src,KRF,reg ;l-byte src with KRF field 
CONNECT Key of reference 

FIND Key of reference 

GET Key of reference 

REWIND Key of reference 


6-123 


CONTROL BLOCK FIELDS 


RAB SUMMARY 


6.7.9 KSZ Field in RAB 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


Contains the size of 
RSKSZ number 

1 byte 

SFETCH dst,KSZ,reg 


SSTORE src,KSZ,reg 
SCOMPARE src,KSZ,reg 


FIND Key size 
GET Key size 
PUT Key size 


the record key for the operation. 


*KSZ field to 1l-byte dst 
;l-byte src to KSZ field 
;l-byte sre with KSZ field 


(bytes) 


(bytes) 
(bytes) 


6-124 


CONTROL BLOCK FIELDS 
RAB SUMMARY 


6.7.10 MBC Field in RAB 


USE Contains the multiblock count for the stream. 

INIT RSMBC number 

SIZE 1 byte 

ACCESS SFETCH dst,MBC,reg ;MBC field to l-byte dst 
SSTORE src,MBC,reg ;l-byte sre to MBC field 


SCOMPARE src,MBC,reg ;l-byte src with MBC field 


INPUT CONNECT Multiblock count 
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6.7.11 MBF 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


Field in RAB 


Contains the multibuffer count for the stream. 


RSMBF number 


l byte 
SFETCH dst ,MBF,reg ;MBF field to l-byte dst 
SSTORE src,MBF,reg ;l-byte src to MBF field 


SCOMPARE src,MBF,reg ;l-byte src with MBF field 


CONNECT Multibuffer count 
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RAC Field in RAB 


Contains the access mode code for the operation. 


RSRAC code 


l byte 
SFETCH dst,RAC,reg ;RAC field to l-byte dst 
SSTORE src,RAC,reg ;l-byte sre to RAC field 


SCOMPARE src,RAC,reg ;l-byte src with RAC field 


RBSKEY Key access 
RBSRFA RFA access 
RBSSEQ Sequential access 


FIND Record access code 
GET Record access code 
PUT Record access code 
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6.7.13 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


OUTPUT 


Contains 
operation. 


RBF Field in RAB 


the 


RSRBF address 


1 word 


SFETCH dst,RBF,reg 
SSTORE src,RBF,reg 


SCOMPARE src,RBF,reg 


PUT 
UPDATE 
WRITE 


CONNECT 
GET 

PUT 
READ 


Record 
Record 
Record 


Record 
Record 
Record 
Record 


address 


of 


the 


record 


buffer 


;RBF field to l-word dst 
;l-word sre to RBF field 


buffer 
buffer 
buffer 


buffer 
buffer 
buffer 
buffer 
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address 
address 
address 
address 


sl-word src with RBF field 


for 


the 
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RFA Field in RAB 


Contains the record file address for the target record. 


None 

3 words 

SFETCH dst,RFA,reg ;RFA field to 3-word dst 
FIND Record file address 

GET Record file address 

CONNECT End-of-file address 

FIND Record file address 

GET Record file address 

PUT Record file address 

READ Virtual block number (2 words) 
WRITE Virtual block number (2 words) 
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6.7.15 RHB Field in RAB 


USE Contains the address of the VFC fixed control area 
for the target record. 


INIT RSRHB address 
SIZE 1 word 
ACCESS SFETCH dst,RHB,reg *RHB field to l-word dst 
SSTORE src,RHB,reg sl-word src to RHB field 
SCOMPARE src,RHB,reg ;l-word sre with RHB field 
INPUT GET VFC control buffer address 
PUT VFC control buffer address 
UPDATE VFC control buffer address 
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ROP Field in RAB (RBSASY Mask) 


6.7.16 
USE Requests asynchronous operation. 
INIT RSROP mask 
SIZE 1 word 
ACCESS SSET mask,ROP,reg ;Mask bits on in ROP field 
SOFF mask,ROP,reg sMask bits off in ROP field 
STESTBITS mask,ROP,reg ;Test mask bits in ROP field 
SFETCH dst,ROP,reg ;ROP field to l-word dst 
SSTORE src,ROP,reg sl-word sre to ROP field 
SCOMPARE src,ROP,reg ;l-word sre with ROP field 
INPUT CONNECT Asynchronous operation 
DELETE Asynchronous operation 
DISCONNECT Asynchronous operation 
FIND Asynchronous operation 
FLUSH Asynchronous operation 
FREE Asynchronous operation 
GET Asynchronous operation 
NXTVOL Asynchronous operation 
PUT Asynchronous operation 
READ Asynchronous operation 
REWIND Asynchronous operation 
SPACE Asynchronous operation 
TRUNCATE Asynchronous operation 
UPDATE Asynchronous operation 
WRITE Asynchronous operation 
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6.7.17 ROP Field in RAB (RBSEOF Mask) 


USE Requests initial stream context at end-of-file. 

INIT RSROP mask 

SIZE 1 word 

ACCESS SSET mask,ROP,reg s;Mask bits on in ROP field 
SOFF mask,ROP,reg sMask bits off in ROP field 
STESTBITS mask,ROP,reg ;Test mask bits in ROP field 
SFETCH dst,ROP,reg ;ROP field to l-word dst 
SSTORE src,ROP,reg :l-word sre to ROP field 


SCOMPARE src,ROP,reg :l-word sre with ROP field 


INPUT CONNECT Position to end-of-file 
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6.7.18 ROP Field in RAB (RBSFDL Mask) 


USE Requests fast deletion. 

INIT RSROP mask 

SIZE 1 word 

ACCESS SSET mask,ROP,reg sMask bits on in ROP field 
SOFF mask,ROP,reg s;Mask bits off in ROP field 
STESTBITS mask,ROP,reg ;Test mask bits in ROP field 
SFETCH dst,ROP,reg ;ROP field to l-word dst 
SSTORE src,ROP,reg ;l-word src to ROP field 


SCOMPARE src,ROP,reg ;l-word src with ROP field 


INPUT DELETE Fast deletion 
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6.7.19 ROP 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


Field in RAB (RBSKGE Mask) 


Requests greater-than-or-equal key match criterion. 


RSROP mask 

1 word 

SSET mask,ROP,reg sMask bits on in ROP field 
SOFF mask,ROP,reg ;Mask bits off in ROP field 
STESTBITS mask,ROP,reg ;Test mask bits in ROP field 
SFETCH dst,ROP,reg ;ROP field to l-word dst 
SSTORE src,ROP,reg ;l-word src to ROP field 
SCOMPARE src,ROP,reg ;l-word src with ROP field 
FIND Greater-than-or-equal key criterion 

GET Greater-than-or-equal key criterion 
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6.7.20 ROP Field in RAB (RBS$KGT Mask) 


USE Requests greater-then key match criterion. 

INIT RSROP mask 

SIZE 1 word 

ACCESS SSET mask,ROP,reg sMask bits on in ROP field 
SOFF mask,ROP,reg ;Mask bits off in ROP field 
STESTBITS mask,ROP,reg ;Test mask bits in ROP field 
SFETCH dst,ROP,reg *;ROP field to l-word dst 
SSTORE src,ROP,reg ;l-word src to ROP field 
SCOMPARE src,ROP,reg sl-word sre with ROP field 

INPUT FIND Greater-than key criterion 
GET Greater-than key criterion 
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6.7.21 ROP 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


Field in RAB (RBSLOA Mask) 


Requests bucket f1i11 number honoring. 


RSROP mask 

l word 

SSET mask,ROP,reg sMask bits on in ROP field 
SOFF mask,ROP,reg ;Mask bits off in ROP field 
STESTBITS mask,ROP,reg ;Test mask bits in ROP field 
SFETCH dst,ROP,reg ;ROP field to l-word dst 
SSTORE src,ROP,reg ;l-word src to ROP field 
SCOMPARE src,ROP,reg s;l-word sre with ROP field 
PUT Honor bucket fill numbers 

UPDATE Honor bucket fill numbers 
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6.7.22 ROP Field in RAB (RBSLOC Mask) 


USE Requests locate mode operation. 

INIT RSROP mask 

SIZE 1 word 

ACCESS SSET mask,ROP,reg ;Mask bits on in ROP field 
SOFF mask,ROP,reg ;Mask bits off in ROP field 
STESTBITS mask,ROP,reg ;Test mask bits in ROP field 
SFETCH dst,ROP,reg s;ROP field to l-word dst 
SSTORE src,ROP,reg :;l-word src to ROP field 
SCOMPARE src,ROP,reg :;l-word sre with ROP field 

INPUT CONNECT Locate mode 
GET Locate mode 
PUT Locate mode 
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6.7.23 ROP Field in RAB (RBS$MAS Mask) 


USE Requests mass insertion. 

INIT RSROP mask 

SIZE 1 word 

ACCESS SSET mask,ROP,reg sMask bits on in ROP field 
SOFF mask,ROP,reg ;Mask bits off in ROP field 
STESTBITS mask,ROP,reg ;Test mask bits in ROP field 
SFETCH dst,ROP,reg ;ROP field to l-word dst 
SSTORE src,ROP,reg *l-word sre to ROP field 


SCOMPARE src,ROP,reg :l-word sre with ROP field 


INPUT PUT Mass insert 
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6.7.24 ROP Field in RAB (RBSUIF Mask) 


USE Requests update if target record already exists. 

INIT RSROP mask 

SIZE 1 word 

ACCESS SSET mask,ROP,reg ;Mask bits on in ROP field 
SOFF mask,ROP,reg ;Mask bits off in ROP field 
STESTBITS mask,ROP,reg ;Test mask bits in ROP field 
SFETCH dst,ROP,reg ;ROP field to l-word dst 
SSTORE src,ROP,reg ;l-word src to ROP field 


SCOMPARE src,ROP,reg ;l-word src with ROP field 


INPUT PUT Update if record exists 
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6.7.25 RSZ Field in RAB 


USE Contains the size of the target record. 
INIT RSRSZ number 
SIZE 1 word 
ACCESS SFETCH dst,RSZ,reg *RSZ field to l-word dst 
SSTORE src,RSZ,reg s;l-word sre to RSZ field 
SCOMPARE src,RSZ,reg sl-word sre with RSZ field 
INPUT PUT Record size (bytes) 
UPDATE Record size (bytes) 
WRITE Record size (bytes) 
OUTPUT GET Record size (bytes) 
READ Record size (bytes) 
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6.7.26 STS Field in RAB 
USE Contains the completion status code for the operation. 
INIT None 
SIZE 1 word 
ACCESS SFETCH dst,STS,reg s;STS field to l-word dst 
SCOMPARE src,STS,reg s;l-word sre with STS field 
OUTPUT CONNECT Completion status code 
DELETE Completion status code 
DISCONNECT Completion status code 
FIND Completion status code 
FLUSH Completion status code 
FREE Completion status code 
GET Completion status code 
NXTVOL Completion status code 
PUT Completion status code 
READ Completion status code 
REWIND Completion status code 
SPACE Completion status code 
TRUNCATE Completion status code 
UPDATE Completion status code 
WRITE Completion status code 


6-141 


CONTROL BLOCK FIELDS 


RAB SUMMARY 


6.7.27 


USE 


INIT 


SIZE 


ACCESS 


OUTPUT 


STV Field in RAB 


Contains the completion status value for the operation. 


None 


1 word 


SFETCH dst,STV,reg 
SCOMPARE src,STV,reg 


CONNECT 
DELETE 
DISCONNECT 
FIND 
FLUSH 
FREE 

GET 
NXTVOL 
PUT 

READ 
REWIND 
SPACE 
TRUNCATE 
UPDATE 
WRITE 


Completion 
Completion 
Completion 
Completion 
Completion 
Completion 
Completion 
Completion 
Completion 
Completion 
Completion 
Completion 
Completion 
Completion 
Completion 


;STV field to l-word dst 
sl-word sre with STV field 


status 
status 
status 
status 
status 
status 
status 
status 
status 
status 
status 
status 
status 
status 
status 
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value 
value 
value 
value 
value 
value 
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value 
value 
value 
value 
value 
value 
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Contains the address of the user buffer for the operation. 


RSUBF address 


1 word 

SFETCH dst,UBF,reg s;UBF field to l-word dst 
SSTORE src,UBF,reg ;l-word src to UBF field 
SCOMPARE src,UBF,reg :l-word src with UBF field 
CONNECT User buffer address 

GET User buffer address 

PUT User buffer address 

READ User buffer address 
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6.7.29 


USE 
INIT 
SIZE 


ACCESS 


INPUT 


USZ Field in RAB 


Contains the size of the user buffer for the operation. 


RSUSZ number 


1 word 


SFETCH dst,USZ,reg 
SSTORE src,USZ,reg 


SCOMPARE src,USZ, 


CONNECT User 
GET User 
PUT User 
READ User 


reg 


buffer 
buffer 
buffer 
buffer 


s;USZ field to l-word dst 


;l-word sre to USZ field 


:;l-word sre with USZ field 


size 
size 
size 
size 
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6.8 SUM BLOCK SUMMARY 
This section summarizes the SUM block and its fields. Table 6-8 
summarizes the entire block, giving the offset, offset symbol, size, 
and a brief description for each field; for a field that has mask or 


code symbols, the table also gives the value, symbol, and a brief 
description for each mask or code. 


Table 6-8: SUM Block Summary 


Offset Field 
Offset Symbol Size Description 
000 OSCOD 1 byte SUM block identifier 
000005 XBSSUM SUM block identifier code 
001 OSBLN 1 byte SUM block length (bytes) 
000012 XBSSML SUM block length (bytes) 
002 OSNXT 
004 OSNOK 


005 OSNOA 
006 OSNOR 


word Next XAB address 

byte Number of indexes 

byte Number of areas 

byte Reserved 

byte Reserved 

word Prologue version number 


el el oo ole Oo 


010 OSPVN 
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6.8.1 BLN Field in SUM Block (XBSSML Code) 


USE Contains the length of the SUM block. 

INIT None 

SIZE 1 byte 

ACCESS SFETCH dst,BLN,reg ;BLN field to l-byte dst 


SCOMPARE src,BLN,reg ;l-byte sre with BLN field 


6-146 


CONTROL BLOCK FIELDS 
SUM BLOCK SUMMARY 


6.8.2 COD Field in SUM Block (XBSSUM Code) 


USE Contains the identifier for the SUM block. 

INIT None 

SIZE 1 byte 

ACCESS SFETCH dst,COD,reg ;COD field to l-byte dst 


SCOMPARE src,COD,reg ;l-byte src with COD field 


6-147 


CONTROL BLOCK FIELDS 


SUM BLOCK SUMMARY 


6.8.3 


USE 
INIT 
SIZE 


ACCESS 


OUTPUT 


NOA Field in SUM Block 


Contains the number of areas in the file. 


None 

l byte 

SFETCH dst,NOA,reg ;NOA field to l-byte dst 
SCOMPARE src,NOA,reg ;l-byte src with NOA field 
DISPLAY Number of areas 

OPEN Number of areas 
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6.8.4 


USE 
INIT 
SIZE 


ACCESS 


OUTPUT 


CONTROL BLOCK FIELDS 
SUM BLOCK SUMMARY 


NOK Field in SUM Block 


Contains the number of indexes in the file. 


None 

1 byte 

SFETCH dst,NOK,reg ;NOK field to l-byte dst 
SCOMPARE src,NOK,reg ;l-byte src with NOK field 
DISPLAY Number of indexes 

OPEN Number of indexes 
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CONTROL BLOCK FIELDS 
SUM BLOCK SUMMARY 


6.8.5 NXT Field in SUM Block 


USE Contains the address of the next XAB (ALL, DAT, KEY, PRO, 
or SUM block) in a chain of XABs. 
INIT XSNXT address 
SIZE 1 word 
ACCESS SFETCH dst,NXT,reg sNXT field to l-word dst 
SSTORE src,NxXT,reg s;l-word sre to NXT field 
SCOMPARE src,NXT,reg :l-word sre with NXT field 
INPUT CLOSE Next XAB address 
CREATE Next XAB address 
DISPLAY Next XAB address 
ENTER Next XAB address 
ERASE Next XAB address 
EXTEND Next XAB address 
OPEN Next XAB address 
PARSE Next XAB address 
REMOVE Next XAB address 
RENAME Next XAB address 
SEARCH Next XAB address 
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CONTROL BLOCK FIELDS 
SUM BLOCK SUMMARY 


6.8.6 PVN Field in SUM Block 


USE Contains the prologue version number for the file. 
INIT None 
SIZE 1 word 
ACCESS SFETCH dst,PVN,reg *PVN field to l-word dst 
SCOMPARE src,PVN,reg s;l-word src with PVN field 
OUTPUT DISPLAY Prologue version number 
OPEN Prologue version number 
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CHAPTER 7 


EXAMPLE PROGRAMS 


This chapter contains example programs; the titles of the 
are: 


@e PARSE - SPARSE TEST 
e@e SEARCH - SSEARCH TEST 
@e ERASE - SERASE TEST 
@ RENAME —- SRENAME TEST 
e GSA - CORE SPACE ALLOCATOR 
Sections 7.1 through 7.4 contain these programs and give in 
for building and running them. 
NOTE 
References to [uic] in the command lines 
in the following sections indicate that 


you should include your default UIC. 


Each program requires the GSA routine (Section 7.5) for 
dynamic memory: 


MAC SY:GSA=LB: [1,1]RMSMAC/ML,SY: [uic]GSA 


programs 


structions 


allocating 


EXAMPLE PROGRAMS 


7.1 PARSE - SPARSE TEST 


The following shows how to build the PARSE program (Example 
shows a brief sample run of the program. 


MAC SY:PARSE=LB: [1,1]RMSMAC/ML, SY: [uic] PARSE 

TKB 

TKB>SY: PARSE/CP=SY: PARSE, SY:GSA 

TKB>LB: [1,1] VMLIB/LB: INIDM: EXTSK 

TKB>LB: [1,1] RMSLIB/LB 

TKB> // 

RUN DB1: {200,1]PARSE 

Enter the default name string: DBO: 

Enter the primary name string: ~.LOG 

SPARSE expanded string is DBO:[70,5].LOG 
File name bits (FNB) are 004202 
(DEV, TYP) 

Enter the default name string: ~Z2 


EXAMPLE PROGRAMS 
Example 7-1: PARSE - SPARSE Test 
-TITLE PARSE - SPARSE TEST 
.IDENT /X01.00/ 
.ENABL LC 
.MCALL FABSB,NAMSB,GSAS 


-MCALL SPARSE,SSTORE, SFETCH, SCOMPARE 
-MCALL ALUNSS,QIOWS,DIRS,EXITSS 


This program tests/demonstrates the use of 
the RMS-11 SPARSE function. 


me se SO SO 


RMS-1l1l Data Structures 


me we Ne 


GSAS GSA 


FAB: : FABSB 
FSNAM NAM 
FSLCH 2. 
FABSE 


Argument FAB 
Link to NAM 
Channel #2 


=e NO ME 


NAM definition 
EXP STR address 
EXP STR length 


NAM: : NAMSB 
NSESA EXPSTR 
NSESS 128. 
NAMSE 


ue NO we 


.PSECT SCODES,R0,I 


PARSE: : 


ALUNSS #1,#"TI,#0 Assign the terminal 


, 
MOV #FAB,RO ; Map the target FAB 
MOV #EDBLK, R2 ; Map the exit block 
MOV #NAM, R3 ; Map the target NAM 
MOV #READ, R4 + Map the input DPB 
MOV #WRITE,RS5S ; Map the output DPB 
CLR Q. IOPL+4 (R5) ; Turn off carriage ctl 
MOV #QUES1,Q.IOPL(R5) 
MOV #QUES1L,Q.IOPL+2(R5) 
DIRS R5 ; Prompt for the DNA 
TSTB IOSTAT ; Check the IOSB 
BMI EXIT > Exit if error 
MOV #BUFF1,Q.IOPL(R4) 
MOV #64.,Q.I1OPL+2 (R4) 
DIRS R4 ; Get the response 
TSTB IOSTAT Check the IOSB 
BMI EXIT Exit if error 


SSTORE IOLEN,DNS,RO 
SSTORE #BUFF1,DNA,R0 


Set the default length 
Set the default address 


=e SO me NON 


MOV #QUES2,Q.1OPL(R5) 

MOV #QUES2L,Q.IOPL+2 (R5) 

DIRS R5 ; Prompt for the DNA 
TSTB IOSTAT ; Check the IOSB 

BMI EXIT ; Exit if error 

MOV #BUFF2,Q.I10PL(R4) 

MOV #64.,0.IOPL+2 (R4) 

DIRS R4 Get the response 


; 
TSTB IOSTAT ; Check the IOSB 
BMI EXIT > Exit if error 
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EXIT: 


ERROR: 


BITS: 


PRINT: 


EXAMPLE PROGRAMS 


SSTORE IOLEN,FNS,RO 
SSTORE #BUFF2,FNA,RO 
MOV #40,Q.IOPL+4 (R5) 
SPARSE RO 

SCOMPARE #0,STS,RO 
BLT ERROR 

CLR (R2) 

SFETCH (R2),ESL,R3 
TST (R2) + 
SFETCH (R2)+,ESA,R3 
SFETCH (R2),FNB,R3 
MOV #ESSSTR,R1 
CALE PRINT 

CALL BITS 

BR PARSE 
EXITSS 

SFETCH (R2)+,STS,RO 
SFETCH (R2),STV,RO 
MOV #ERRSTR,R1 
CALL PRINT 

BR PARSE 

MOV #EDBLK, R2 
SFETCH RO,FNB,R3 
BIT #2000,R0 
BEQ 2s 

MOV #QUO, (R2)+ 
BIT #1000,R0 
BEQ 4s 

MOV #WDI, (R2) + 
BIT #400,R0 

BEQ 6S 

MOV #NOD, (R2) + 
BIT #100,R0 

BEQ 8S 

MOV #DIR, (R2) + 
BIT #40,R0 

BEQ 108 

MOV #WNA, (R2) + 
BIT #20,RO0 

BEQ 128 

MOV #WTY, (R2) + 
BIT #10,RO0 

BEQ 148 

MOV #WVE, (R2)+ 
BIT #4,R0 

BEQ 16S 

MOV #NME, (R2) + 
BIT #2,R0 

BEQ 188 

MOV #TYP,(R2)+ 
BIT #1,R0 

BEQ 208 

MOV #VER, (R2) + 
MOV #END, (R2) 
MOV #DEV,R1 
CALL PRINT 
RETURN 

MOV #EDBLK, R2 


=e MO Ne MO NO TH NO NO We NH We We We WH We 


=e 


=e WO we NO NO 


we me NO Ne NO MO TNO we TH Me NH Ne NO We WOH we TWH Te NSH We WH We NH We WH We NS wWe NWO We BO We “OC we NO WE 


Set the default length 
Set the default address 
Restore carriage control 
Parse the strings 

An error? 

Yes if MI; display it 
Init the length 

Get the string length 
Advance 

Get the string address 
Get the file name bits 
Select the format string 
Display the file 

Do the FNB bit disply 
And let's try another 


Task exit 


Set the STS returned 

And the STV 

Set the error format string 
Go edit and print the message 
Let's try this again 


Init EDBLK address 
Get the FNB bits 
Quoted string? 

No if EQ 

Set Quoted string 
Wild directory? 

No if EQ 

Set wild directory 
Node spec? 

No if EQ 

Set nodespec 
Directory spec? 

No if EQ 

Set directory 

Wild name? 

No if eq 

Set wild name 

Wild type? 

No if EQ 

Set wild type 

Wild version? 

No if EQ 
Set wild 
Name? 

No if EQ 
Set name 
Type? 

No if EQ 
Set type 
Version? 
No if EQ 
Set version 

End with a null... 
Set the default (dev) 
Edit and print 

And exit 


version 


Setup edit 


QUES1: 
QUES2: 


ERRSTR: 
ESSSTR: 


DEV: 
NOD: 
DIR: 
NME: 
QUO: 
TYP: 
VER: 
WDI: 
WNA; 
WTY: 
WVE: 
END: 


EDBLK: 
BUFFER: 
BUFF 1: 
BUFF2: 
EXPSTR: 
IOSTAT: 
IOLEN: 
READ: 
WRITE: 


MOV 
CALL 
MOV 
MOV 
DIRS 
RETURN 


- PSECT 


-Ascii 
QUESIL 
-Ascii 
QUES2L 
-Asciz 
-Ascil 
-Asciz 
-Asciz 
-Asciz 
-Asciz 
-Asciz 
-Asciz 
-Asciz 
-Asciz 
-Asciz 
-Asciz 
-Asciz 
-Asciz 
-Asciz 


- EVEN 
-BLKW 


-Bikb 
-Blkb 
-BLKB 
-WORD 
«WORD 
QIOWS 
QIOWS 


- END 


EXAMPLE 


Output buffer 


#BUFFER, RO ; 
; Exit the string 


SEDMSG : 
#BUFFER,Q. IOPL(R5) 
R1,Q.IOPL+2 (R5) 
R5 Send to the terminal 


; 
; Return to caller 


SDATAS,RW,D 


<15><12>"Enter the default name string: " 
= . - QUESIL 

<15><12>"Enter the primary name string: " 
= ,. — QUES2 . 

"SPARSE error -- STS=%P, STV=%P" 

"SPARSE expanded string is %VA%N" 

" File name bits (FNB) are %P" 

" (DEV3I" 

") NODSI" 

, DIR$I" 

, NAMSI" 

, QUOZI" 
", TYPSI" 

, VERSI" 

, WDISI" 

, WNASI" 

, WTY$SI" 
", WVESI" 


16. 


64. 

64 

128. 

0 

0 

IO.RLB,1,1,,1OSTAT 
IO.WLB,1,1,,1O0STAT, ,<,,40> 


PARSE 


PROGRAMS 


EXAMPLE PROGRAMS 


7.2 SEARCH ~- SSEARCH TEST 


The following shows how to build the SEARCH program 
shows a brief sample run of the program. 


MAC SY:SEARCH=LB: [1,1]RMSMAC/ML,SY: [uic] SEARCH 
TKB 

TKB> SY: SEARCH/CP=SY:SEARCH,SY:GSA 

TKB>LB: [1,1] VMLIB/LB: INIDM: EXTSK 

TKB>LB: [1,1]RMSLIB/LB 

TKB> // 

RUN DB1:[200,1]SEARCH 


Enter a wildcard filespec: VHC*.* 
DBO: [70,5] VHC.SEQ;1 

DBO: [70,5] VHC. INX;7 

DBO: [70,5] VHCKRO.DES;3 

DBO: [70,5] VHC.DES;2 

DBO: [70,5] VHC.MST;1 

DBO: [70,5] VHC.ERR;1 

DBO: [70,5] VHC.KRO;1 

DBO: [70,5] VHC.KR1;1 

DBO: [70,5] VHCKRO. INX;3 


Total of 9 files matching DBO: [70,5] VHC*.* 
Enter a wildcard filespec: [70,*]CUST.* 
DBO: [{70,10]CUST.FILE;1 

DBO: [70,10]CUST.SEQ;1 

DBO: [70,5]CUST.MST;1 

DBO: [70,5]CUST.FIL;1 

Total of 4 files matching DBO: [70,*]CUST.* 


Enter a wildcard filespec: “Z 


(Example 7-2) 


and 


me me Se NE 


~e te tO 


FAB: : 


NAM: : 


SEARCH: 


GETFIL: 


- TITLE 
- IDENT 


- ENABL 


-MCALL 
»MCALL 
-MCALL 


GSAS 


FABSB 
FSDNA 
FSDNS 
FSNAM 
FSLCH 

FABSE 


NAMSB 
NSESA 
NSESS 
NSRSA 
NSRSS 

NAMSE 


- PSECT 


ALUNSS 
MOV 
MOV 
MOV 
MOV 
MOV 
CLR 
MOV 
MOV 
DIRS 
TSTB 
BMI 
MOV 
MOV 
DIRS 
TSTB 
BMI 
SSTORE 
SSTORE 
MOV 
CLR 
SPARSE 


SCOMPARE #0,STS,R0O 


BLT 


Example 7-2: 
SEARCH - SSEARCH TEST 
/X01.00/ 

LC 


FABSB,NAMSB,GSAS 


SEARCH — SSEARCH Test 


EXAMPLE PROGRAMS 


SPARSE, SSEARCH, SSTORE, SFETCH, SCOMPARE 
ALUNSS, QIOWS, DIRS, EXITSS 


RMS-l11l Data Structures 


This program tests/demonstrates the use of 
the RMS-11 SSEARCH function. 


GSA 

; Argument FAB 
SYDSKA * TE no: device, 
SYDSKL ; should be used 
NAM ; Link to NAM 
2 ; Channel #2 

; NAM definition 
EXPSTR ; EXP STR address 
128. ; EXP STR length 
RESSTR , RES STR address 
128.5 ; RES STR length 


SCODES,RO,I 


#1,#"TI, #0 ; 

#FAB,RO ; Map 

#EDBLK,R2 ; Map 

#NAM,R3 ; Map 

#READ,R4 ; Map 

#WRITE,RS ; Map 
tf 


Q.IOPL+4 (R5) 
#QUES,Q.IOPL(R5) 
#QUESL,Q. IOPL+2 (R5) 
R5 4 
IOSTAT 

EXIT 
#BUFF,Q.IOPL(R4) 
#64.,Q.IOPL+2(R4) 
R4 

IOSTAT 

EXIT 
IOLEN,FNS,RO 
#BUFF,FNA, RO 
#40,Q.IOPL+4 (R5) 
FILCNT 

RO 


=e ue NS 


me we MO Ne MO Ne NO NO TO NO 


ERROR 


the 
the 
the 
the 
the 


Prompt for the DNA 
Check the IOSB 
Exit if error 


Get the response 
Check the IOSB 
Exit if error 
Set the string length 
Set the string address 
Restore carriage control 
Init count of matches 
Parse the strings 

An error? 
Yes if MI; display it 


SY: 


Assign the terminal 
target FAB 
exit block 
target NAM 
input DPB 
output DPB 
Turn off carriage ctl 


NOTEST: 


EXIT: 


ERROR: 


ERROR2: 


ERRORO: 


ERROR1: 


PRINT: 


SYDSKA: 
QUES: 
ERRSTR: 


RSSSTI1: 
RSSSTR: 


EXAMPLE PROGRAMS 


MOV #EDBLK,R2 ; 
SSEARCH RO ’ 
SCOMPARE #0,STS,RO ; 
BLT ERROR ; 
CLR (R2) ; 
SFETCH (R2),RSL,R3 ; 
TST (R2)+ ; 
SFETCH (R2)+,RSA,R3 ; 
MOV #RSSSTR,RI1 ; 
TST FILCNT 7 
BNE NOTFST ; 
MOV #RSSST1,R1 : 
CALL PRINT ; 
MOV #FAB,RO ; 
INC FILCNT ; 
BR GETFIL 7 
EXITSS ; 
SCOMPARE #ERSNMF,STS,RO ; 
BNE ERRORO : 
MOV FILCNT, (R2) + ; 
BEQ ERROR2 ; 
CLR (R2) ; 
SFETCH (R2),ESL,R3 ; 
TST (R2)+ : 
SFETCH (R2),ESA,R3 ; 
MOV #TTLSTR,R1 : 
BR ERROR1 : 
CLR = (R2) : 
SFETCH (R2),ESL,R3 ; 
TST (R2)+ : 
SFETCH (R2),ESA,R3 ; 
MOV #NOFILE,RL1 ; 
BR ERRORL ; 
SFETCH (R2)+,STS,RO ; 
SFETCH (R2),STV,RO ; 
MOV #ERRSTR,R1 ; 
CALL PRINT ; 
JMP SEARCH ; 
MOV #EDBLK,R2 H 
MOV #BUFFER, RO ; 
CALL SEDMSG ; 
MOV #BUFFER,Q.IOPL(R5) 
MOV R1,Q.IOPL+2 (R5) 
DIRS R5 7 
RETURN ; 
- PSECT SDATAS,RW,D 
-ASci1i “SY:" 

SYDSKL = . —- SYDSKA 
-AScii <15><12>"Enter 
QUESL = . -— QUES 

-Asciz "“SSEARCH error -- 
-Ascii "SN" 

-Asciz " SVA" 


Reset the edit block addr 
Get a matching file 
Error? 

Yes if LT 

Init the length 

Get the string length 
Advance 

Get the string address 
Select the format string 
First file needs a blank 
line before it 

Insert CR/LF first 


Display the file 

Rest the FAB address 
Count this file 

And let's try another 


Task exit 


No more matches? 

No - some other error 
Set the cound of matches 
No files... 

Give the ESA 

Set the length 

Advance word 

Set the address 

Set the format string 

Go show it and exit 


Setup for string length 
Set the length 

Advance to next word 
Set the address 

Set the format string 
Print the error 


STS returned 
STV 


Set the 
And the 
Set the 


Go edit 
Let's try this again 


Setup edit 
Output buffer 
Exit the string 


Send to the terminal 
Return to caller 


a wildcard filespec: " 


STS=$P, STV=%P" 


error format string 


and print the message 


NOFILE: .Asciz 
TTLSTR: .Asciz 
~ EVEN 
FILCNT: .WORD 
EDBLK: -BLKW 
BUFFER: 
BUFF: ~-Blkb 
EXPSTR: .BLKB 
RESSTR: .BLKB 
IOSTAT: .WORD 
IOLEN: ~WORD 
READ: QIows 
WRITE: QIOWS 


- END 


"SNNo files matching %VA%N" 
"SNTotal of *D files matching %VA%N" 


0 
6 


128. 
E28. 
128. 
0 
0 


IO.RLB,1,1,,IOSTAT 


IO.WLB,1,1,,I1OSTAT,,<,,40> 


SEARCH 


EXAMPLE PROGRAMS 


EXAMPLE PROGRAMS 


7.3 ERASE - SERASE TEST 


The following shows how to build the ERASE program (Example 
shows a brief sample run of the program. 


MAC SY:ERASE=LB: [1,1]RMSMAC/ML,SY: [uic] ERASE 
TKB 

TKB>SY: ERASE/CP=SY: ERASE,SY:GSA 

TKB>LB: [1,1] VMLIB/LB: INIDM: EXTSK 
TKB>LB:[1,1]RMSLIB/LB 

TKB> // 

RUN DB1:[200,1] ERASE 

File(s) to erase: DES. xxx 


File DBO:[70,5]DES.XxXx;3 deleted 
Total of 1 files matching DBO:[70,5]DES.XXX deleted 


File(s) to erase: “7 


me me SMO NS 


me me NO 


FAB: : 


NAM: : 


ERASE:?:: 


GETFIL: 


-TITLE 
~ IDENT 


- ENABL 


-MCALL 
-MCALL 
-MCALL 


GSAS 


FABSB 
FSDNA 
FSDNS 
FSNAM 
FSLCH 

FABSE 


NAMSB 
NSESA 
NSESS 
NSRSA 
NSRSS 

NAMSE 


- PSECT 


ALUNSS 
MOV 
MOV 
MOV 
MOV 
MOV 
CLR 
MOV 
MOV 
DIRS 
TSTB 
BMI 
MOV 
MOV 
DIRS 
TSTB 
BMI 
SSTORE 
SSTORE 
MOV 
CLR 
SPARSE 


SCOMPARE #0,STS,RO 


BLT 


Example 7-3: 


EXAMPLE PROGRAMS 


ERASE - SERASE Test 


ERASE - SERASE TEST 


/X01.00/ 
LC 


FABSB,NAMSB,GSAS 


SPARSE, SERASE, SSTORE, SFETCH, SCOMPARE 
ALUNSS,QIOWS,DIRS, EXITSS 


RMS-11 Data Structures 


GSA 


SYDSKA 
SYDSKL 
NAM 

2 


ue ™O we NO NO 


EXPSTR 
128. 
RESSTR 
128. 


ue MO mMOe NO MO 


SCODES,RO,I 


#1,#"TI,#0 
#FAB,RO 
#EDBLK, R2 
#NAM,R3 

#READ,R4 
#WRITE,R5 

Q. IOPL+4(R5) 
#QUES,Q.IOPL(R5) 


me ™O Ne MO NO MO NO 


This program tests/demonstrates the use of 
the RMS-11 SERASE function, with implicit S$SEARCH. 


Argument FAB 
If no device, 
should be used 
Link to NAM 
Channel #2 


SY: 


definition 
STR address 
STR length 
STR address 
STR length 


NAM 
EXP 
EXP 
RES 
RES 


Assign the terminal 
Map the target FAB 
Map the exit block 
Map the target NAM 
Map the input DPB 
Map the output DPB 
Turn off carriage ctl 


#QUESL,Q.IOPL+2(R5) 


R5 ; 
IOSTAT ; 
EXIT ; 
#BUFF,Q.IOPL(R4) 
#64.,Q.I1OPL+2(R4) 
R4 

IOSTAT 

EXIT 

IOLEN, FNS, RO 
#BUFF,FNA, RO 
#40,Q.1OPL+4(R5) 
FILCNT 

RO 


mo ue TO NO TSE MO WH We NWO WE 


ERROR 


Prompt for the DNA 
Check the IOSB 
Exit if error 


Get the response 

Check the IOSB 

Exit if error 

Set the string length 
Set the string address 
Restore carriage control 
Init count of matches 
Parse the strings 

An error? 

Yes if MI; display it 


EXAMPLE PROGRAMS 


MOV 
SERASE 
SCOMPARE 
BLT 
CLR 
SFETCH 
TST 
SFETCH 
MOV 
TST 
BNE 
MOV 
NOTFST: 
CALL 
MOV 
INC 
BR 


EXIT: 
EXITSS 


ERROR: 


SCOMPARE #ERSNMF,STS,RO 


BNE 
MOV 
BEQ 
CLR 
SFETCH 
TST 
SFETCH 
MOV 
BR 
ERROR2: 
CLR 
SFETCH 
TST 
SFETCH 
MOV 
BR 
ERRORO: 
SFETCH 
SFETCH 
MOV 
ERROR1?: 
CALL 
JMP 


PRINT: 

MOV 
MOV 
CALL 
MOV 
MOV 
DIRS 
RETURN 


- PSECT 
SYDSKA: .Ascii 
SYDSKL = 
-Ascil 
QUESL = 
-Asciz 
-Ascii 
-ASC1Z 


QUES: 


ERRSTR: 
RSSST1: 
RSSSTR: 


#EDBLK,R2 
RO 
#0,STS,RO 
ERROR 
(R2) 
(R2) ,RSL,R3 
(R2)+ 
(R2)+,RSA,R3 
#RSSSTR,R1 
FILCNT 
NOTFST 
#RSSST1,R1 


PRINT 
#FAB, RO 
FILCNT 
GETFIL 


ERRORO 
FILCNT, (R2)+ 
ERROR2 

(R2) 

(R2) ,ESL,R3 
(R2)+ 

(R2) ,ESA,R3 
#TTLSTR,RI1 
ERRORL1 


-(R2) 

(R2) ,ESL,R3 
(R2) + 

(R2) ,ESA,R3 
#NOFILE,R1 
ERROR1 


(R2)+,STS,RO 
(R2) ,STV,RO 
#ERRSTR,R1 


PRINT 
ERASE 


#EDBLK, R2 
#BUFFER, RO 
SEDMSG 


#BUFFER,Q.IOPL(R5) 
R1,Q.IOPL+2 (R5) 


R5 


SDATAS, RW,D 


"Sy:" 
° = SYDSKA 


~e me ME Ne NO Ne MO We WH We WOH WE 


me me NO NO 


=e 


“Oe we SO uO NO Te MSE NO NO NO 


=e ~e "Oe we “OP NO 


mo MO Ne 


=e se 


. 
’ 
. 
, 
. 
, 

5 


Reset the edit block addr 
Issue implicit SERASE 
Error? 

Yes if LT 

Init the length 

Get the string length 
Advance 

Get the string address 
Select the format string 
First file needs a blank 
line before it 

Insert CR/LF first 


Display the file 

Rest the FAB address 
Count this file 

And let's try another 


Task exit 


No more matches? 

No - some other error 
Set the cound of matches 
No files... 

Give the ESA 

Set the length 

Advance word 

Set the address 

Set the format string 

Go show it and exit 


Setup for string length 
Set the length 

Advance to next word 
Set the address 

Set the format string 
Print the error 


Set the 
And the 
Set the 


STS returned 
STV 


Go edit 
Let's try this again 


Setup edit 
Output buffer 
Exit the string 


Send to the terminal 
Return to caller 


<15><12>"File(s) to erase: " 


- - QUES 


"SERASE error 


" =n" 


STS=3P, 


STV=%P" 


" File VA deleted" 


7-12 


error format string 


and print the message 


EXAMPLE PROGRAMS 


NOFILE: .Asciz "%$NNo files matching %VA%N" 

TTLSTR: .Asciz "%SNTotal of %D files matching %VA deleted3N" 
~ EVEN 

FILCNT: .WORD 0 

EDBLK: -BLKW 6 

BUFFER: 

BUFF: ~-Blkb 123. 

EXPSTR: .BLKB 128. 

RESSTR: .BLKB 128... 

IOSTAT: WORD 0 

IOLEN: -WORD 0 

READ: QIOWS IO.RLB,1,1,,I1OSTAT 

WRITE: QIOWS IO.WLB,1,1,,IOSTAT, ,<,,40> 


- END ERASE 


EXAMPLE PROGRAMS 


7.4 RENAME —- SRENAME TEST 


The following shows how to build the RENAME program (Example 7-4) 


shows a brief sample run of the program. 


MAC SY:RENAME=LB: [1,1]RMSMAC/ML,SY: [vic] RENAME 
TKB 
TKB>SY: RENAME/CP=SY:RENAME,SY:GSA 
TKB>LB:SYSLIB/LB: INIDM: EXTSK 
TKB>LB: [1,1]RMSLIB/LB 
PKE>// 
RUN DB1:[200,1] RENAME 
From: DES.TMP 
TO: DES.XXX 
File DBO:[70,5]DES.TMP;3 renamed to DB0:[70,5]DES.XXX;3 


Total of 1 files matching DBO:[70,5]DES.TMP renamed 


“A 


From: 7, 


me me MO NO 


me ue NO 


FABL:: 


NAM1:: 


FAB2:: 


NAM2:: 


RENAME: : 


- TITLE 
- IDENT 


- ENABL 


-MCALL 
-MCALL 
-MCALL 


GSAS 


FABSB 
FSDNA 
FSDNS 
FSNAM 
FSLCH 
FSFOP 

FABSE 


NAMSB 
NSESA 
NSESS 
NSRSA 
NSRSS 

NAMSE 


FABSB 
FSNAM 
FSLCH 

FABSE 


NAMSB 
NSESA 
NSESS 

NAMSE 


- PSECT 


ALUNSS 
MOV 
MOV 
MOV 
MOV 
CLR 
MOV 
MOV 
DIRS 
TSTB 
BMI 
MOV 
MOV 


EXAMPLE PROGRAMS 


Example 7-4: RENAME - SRENAME Test 


RENAME - SRENAME TEST 


/X01.00/ 


LC 


FABSB,NAMSB, GSAS 


SPARSE, SSEARCH, SRENAME, SSTORE, SFETCH, SCOMPARE 
ALUNSS,QIOWS,DIRS,EXITSS 


RMS-1ll Data Structures 


GSA 


SYDSKA 
SYDSKL 
NAM1 
Zs 
FBSFID 


ESSTR1 
128. 
RSSTR1 
128. 


NAM2 
2. 


ESSTR2 
E283 


SCODES,RO,I 


#1,#"T1I,#0 
#FAB1,R0 
#EDBLK, R2 
#READ,R4 
#WRITE,RS5 

Q. IOPL+4 (R5) 


=e se 


me SO Ne 


ume MO uO MO NO 


se ™e NO 


=e “6 tw 


=e ume SO SO “MO NO 


#QUES1,Q.IOPL(RS5) 
#QUES1L,Q. I1OPL+2(R5) 


R5 
IOSTAT 
EXIT 


ue SOB NO 


#BUFF1,Q.IOPL(R4) 
#64.,Q.I10PL+2(R4) 


This program tests/demonstrates the use of 
the RMS-1l1 SRENAME function. 


Old file name 
Default to SY: 


Link to NAM1 
Channel #2 
Turn on NAM uSage 


NAM definition 
EXP STR address 
EXP STR length 
RES STR address 
RES STR length 


New file name 
Link to NAM2 
Same channel 


NAM definition 
EXP STR address 
EXP STR length 


Assign the terminal 
Map the target FAB 
Map the exit block 
Map the input DPB 

Map the output DPB 
Turn off carriage ctl 


Prompt for the DNA 
Check the IOSB 
Exit if error 
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EXIT: 


LOOP: 


ERROR: 


SEAERR: 


EXAMPLE PROGRAMS 


=e ™OF Ne TO Me NO Ne NO NO 


emo “NO 


se ~e SO we SO Ws NON 


me MH Me MOH we ME Te TH Te WH WH Ne We We We WH We WH We WH We WH We WH We WH We 


Get the response 

Check the IOSB 

Exit if error 

Set the default length 
Set the default address 
Parse the input spec 

An error? 

Yes if LT 

Map the 2d FAB 


Prompt for the new name 
Check the IOSB 
Exit if error 


Get the response 

Check the IOSB 

Exit if error 

Set the default length 
Set the default address 
Restore carriage control 
Initialize file count 
Enter the RENAME loop 


Task exit 


Get the input FAB 
And the output FAB 
Setup NAM references 


Attempt to find a file 
ELE OE? 

Yes if LT 
Get 
Set this as default 
Get the resultant length 
Set the default length 
Rename input as output 
Error? 

Yes if LT- investigate 


Setup to show the rename 


Set the 
Advance 
Set the 


length 
to next word 
address 


Set the length 
Advance to next word 
Set te address 
Format string 
Display it 

Count the file 

And try another file 


Map the edit block 

Set the STS returned 

And the STV 

Set the error format string 
Go edit and print the message 


DIRS R4 

TSTB IOSTAT 

BMI EXIT 

SSTORE IOLEN,DNS,RO 
SSTORE #BUFF1,DNA,RO0 
SPARSE RO 

SCOMPARE #0,STS,RO 

BLT ERROR 

MOV #FAB2,RO 

MOV #QUES2,Q.IOPL(R5) 
MOV #QUES2L,Q.IOPL+2(R5) 
DIRS R5 

TSTB IOSTAT 

BMI EXIT ; 
MOV #BUFF2,Q.IOPL(R4) 
MOV #64.,Q.I1O0PL+2(R4) 
DIRS R4 

TSTB IOSTAT 

BMI EXIT 

SSTORE IOLEN,FNS,RO 
SSTORE #BUFF2,FNA,RO 
MOV #40,Q.IOPL+4 (R5) 
CLR FILCNT 

BR LOOP 

EXITSS 

MOV #FAB1,RO 

MOV #FAB2,R1 

MOV #NAM1,R2 

MOV #NAM2,R3 
SSEARCH RO 

SCOMPARE #0,STS,RO 

BLT SEAERR 

SFETCH R4,RSA,R2 
SSTORE R4,DNA,R1 
SFETCH R4,RSL,R2 
SSTORE R4,DNS,R1 
SRENAME RO,,,R1 
SCOMPARE #0,STS,RO 

BLT ERROR 

MOV #EDBLK, RO 

CLR (RO) 

SFETCH (RO),RSL,R2 

TST (RO) + 

SFETCH (RO)+,RSA,R2 
CLR (RO) 

SFETCH (RO),ESL,R3 

TST (RO) + 

SFETCH (RO) ,ESA,R3 

MOV #RENMSG,R1 

CALI PRINT 

INC FILCNT 

BR LOOP 

MOV #EDBLK, R2 

SFETCH (R2)+,STS,RO 
SFETCH (R2),STV,RO 

MOV #ERRSTR,R1 

CALL PRINT 

IMP RENAME 


se me “@ me NO Ne 


Let's try this again 


the resultant address 


SETES: 


TOTAL: 


PRINT: 


SYDSKA: 
QUESI1: 
QUES2: 


ERRSTR: 
RENMSG: 
TTLMSG: 
NOFILE: 


FILCNT: 
EDBLK: 
BUFFER: 
BUFF 1: 
BUFF2: 
E 
ESSTR2: 
RSSTR1: 
IOSTAT: 
IOLEN: 
READ: 

WRITE: 


STR1: 


SCOMPARE #ERSNMF,STS,RO 


BNE 
MOV 
TST 
BNE 
MOV 


CLR 
SFETCH 
TST 
SFETCH 
CALL 
JMP 


MOV 
MOV 
BR 


MOV 
MOV 
CALL 
MOV 
MOV 
DIRS 
RETURN 


- PSECT 


-Ascii 
SYDSKL 
-Ascii 
QUESILL 
-Ascii 
QUES2L 
-Asciz 
-Asciz 
-Asciz 
-Asciz 


- EVEN 
-WORD 
- BLKW 


-BLKB 
- BLKB 
-BLKB 
- BLKB 
-BLKB 
-WORD 
-WORD 
QIOWS 
QIOWSs 


- END 


ERROR 
#EDBLK,RO 
FILCNT 
TOTAL 
#NOFILE,R1 


me MO Ne NO we NO 


(RO) 

(RO) ,ESL,R2 
(RO) + 

(RO) +,ESA,R2 
PRINT 

RENAME 


=e se “OG “oe “OO SO 


FILCNT, (RO) + 
#TTLMSG,R1 
SETES 


=e ™Oe Me 


#EDBLK,R2 ; 
#BUFFER, RO ; 
SEDMSG * 
#BUFFER,WRITE+Q.I10 
R1,WRITE+Q. IOPL+2 
#WRITE ; 


’ 
° 
, 


SDATAS,RW,D 


"sye:" 

- - SYDSKA 
<15><12>"From: " 

- - QUESI 
<15><12>"To: " 

- - QUES2 
"SRENAME error —-- 
"File VA rename 
"SNTotal of $D fil 
"SNNo files matchi 


(oo) 


IO.RLB,1,1,,I1O0STAT 
IO.WLB,1,1,,I1OSTAT 


RENAME 


EXAMPLE PROGRAMS 


End of wild card search? 


No if NE- show why 
Map the edit block 
Any files? 

Yes if NE, show total 
Show the total 


Set the 
Advance 
Get the 


length 

ESA address 
Repeat 
Set the 


Set the 
Add ESA 


rename count 
format string 
and print 


Setup edit 
Output buffer 
Exit the string 
PL 


Send to the terminal 
Return to caller 


STS=$P, STV=%P" 
d to %VA" 
es matching %VA 
ng $VASN" 


renamed%3N" 


EXAMPLE PROGRAMS 
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GSA -- CORE SPACE ALLOCATOR 


Ex 


-Title 
-Ident 


-Enabl 


Copyright 


(C) 


ample 7-5: GSA - Core Space Allocator 


GSA - Core space allocator 
/V02.00/ 
LC 


1982, Digital Equipment Corporation 
Maynard, Massachusetts 01754 


**-GSA - Dynamic memory allocation for RMS-11 pool 


Called by RMS-11l to manage pool space. 
In the event of pool exhaustion, the task 
image will be extended to obtain more space. 


May be called by user written code providing 
the interface standard is adhered to. 


Interface: 


Request space: 
RO -> RMS/user Pool list head (maintained by RL/CQB) 
Rl := Amount of space requested (bytes) 
R2 := 0 (differentiates between request and release) 
Release space: 
RO -> RMS Pool list head (maintained by RL/CQB) 
Rl := Amount of space to be released (bytes) 
R2 -> Base address (for release) 
Returns: 
C-Bit "set" if an error has occurred (failure) 


C-Bit "clear" if no error has occurred (success) 


-Mcall 


- Page 
@Sbttl 


-Psect 


GSA internal 


Extkss 


Control block definitions 


GSASS$D,RW,D 


data: 


GSABAS - Base address for the next memory allocation. 


GSAMIN - 


GSAREQ - 


In 
th 
cu 
De 
(1 
pr 


itially set to zero, it will be assigned 
e first address outside of the task's 
rrent address limits. 

cimal value reflecting the minimum size 
n bytes) to extend the task in order to 
ovide space to the pool. 


Requested pool block number. If a request 


fo 
al 
fa 


r the 'GSAMIN' fails, then the original 
location size will be attempted. If that 
ils, then there iS no more memory left. 
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e 
f 


GSABAS:: 
GSAMIN:: 


GSAREQ:: 


“=e ™e SO Ne BO Ne Se NS We We SO NSH NO WE 


EXAMPLE PROGRAMS 


GSA base address 

(for next allocation) 
Minimum allocation 

(in 32-word blocks) 

Size of this request 

(if 'GSAMIN' extends fail) 


-Word 000000 


Word 512./64. 


™Oe me TO ue VO we 


-Word 000000 


- Page 
-Sbttl GSA Initialization code 


.Psect GSASSI,RO,I 


GSA Initialization 


This code is entered when GSA is entered with GSABAS 
set to zero. In order to be able to build valid pool 
header tables, GSABAS must be properly initialized and 
maintained. 


Initialization consists of finding the size of the task 

in 32-word units, and converting that value to a usable 

16-bit address (which corresponds to the address of the 

next task extension (Extk$S) call. Once GSABAS has been 
initialized, GSAINI will not be reused. 


GSAINI: 
Mov RO,-(SP) s RO-2 will be used to 
Mov R1l,-(SP) ; communicate with SINIDM 
Mov R2,-(SP) ; NOTE: SINIDM uses EXTSK, 


we ue Ne NO Ne TS Ne NO NO NO TE Ne NO Ne TO NO NO NO 


The following code will use SINIDM to initialize the 
dynamic memory. As documented, R1 will return 
the first address following the task image, and R2 will 


return the size of the "free" memory from that address. 


NOTE: SINIDM and EXTSK reside in LB:[{1l,1]VMLIB for RSX 
systems, and in LB:SYSLIB for RSTS/E systems. 


SINIDM interface: 
Calls: 
RO -> Pool list head 


Returns: 
RO -> First address in task 
Rl -> First address AFTER task 
R2 := Size of free core after task (based at R1) 


Call SINIDM Initialize dynamic memory 


, 
Mov R1,GSABAS ; Setup the "free" address 
Mov (SP) +,R2 ; Restore the registers 
Mov (SP) +,R1 ; 
Mov (SP) +,R0O : 
Return ; And return to GSA 
-Page 


-Sbttl GSA Mainline code 


-Psect GSASSM,RO,I 


EXAMPLE PROGRAMS 


ue Me Ne TE NO NO 


GSA Mainline 


Entry point is "GSA", with registers 0-2 loaded as 
described above. 


GSA:: 


“MO Me Ne TO Ne NO NO NO NO WOH MO NO NO Ne 


First, determine if dynamic memory has been initialized. 
GSABAS (initially set to zero) will be non-zero if SINIDM 
has been called and the memory list initialized. On RSX 
based systems it is possible to install tasks with an 
extension (/INCREMENT). SINIDM will detect this and setup 
the first memory entry in the pool list. 


A point to note: If the RSX task has been installed with 
the non-checkpointable (/-CP) flag, then EXTKs will not 
return success. If it is necessary to install the task 
non-checkpointable, then the task should be installed with 
an increment value. 


TSst GSABAS ; Dynamic memory initialized? 
Bne 10$ ; Yes if NE, proceed 
Call GSAINI ; Otherwise, initialize pool 


108: 


me we Ne ONE 


Determine if this call involves real memory. 

Rl should contain the size (in bytes) of the core 
block requested or to be released. If zero then 
return to the caller without an error (TST leaves CC). 


Tst Rl ; Real memory? 
Bne 20S ; Yes if NE, then process it 
Return ; Otherwise return with success 


209% 


=e ™e Me NE NS MO NS 


If this call is a request for space, pass control 

to the allocation routines. Otherwise, pass control 
to the system deallocation module $RLCB. There is 
no need to return, so control is passed via JMP. 
Note that module RQLCB resides in LB: {[{1,1]SYSLIB 

for RSX11M/M-PLUS and LB:SYSLIB for RSTS/E. 


Tst R2 ; Address specified? (release) 
Beq 30S >; No if EQ, then it's a request 
Jmp SRLCB ; Otherwise it's a release; do it 


30S: 


me MO Ne WO Ne ON 


Save our current context: 
RO = Pool list head 
Rl = Size of memory required 
R2 0 (Signifies request) 


Mov RO,-(SP) 
Mov R1,-(SP) 
Mov R2,-(SP) 


me MO TO TO TSU NOH Ne TH We NH TE TWH We we Ns We =e NO “MO NO ME 


we Ne Se TH Me NO 


se se Ne Ne SE Ne TWO NS 


me =O SO NB ME SSO 


EXAMPLE 


Attempt an allocation from the current pool 
If this is successful, pass control to the 
common exit. 


Call SRQCB 
Bec 70S 


Try the allocation 
CC signifies success 


=e owe 


Now that the initial allocation failed, we must extend 
the task and give the new area (extended into) to the 
caller. To do this, the following procedure is used: 


l. The task is extended 
2. The area extended is returned to the 
pool specified as if a release was attempted 
3. We retry the allocation operation, but 
this time it should succeed, since we have 
increased the size of the pool area 


NOTE: SRQCB has a bad habit of nuking registers, so it 
becomes necessary to save and restore them around 
unsuccessful calls. 


Mov 2(SP) ,R1 ; Obtain the request size 


Determine what the requirement is in 32-word blocks. 
Retain this value to allow GSA to decide whether 

to issue further task extension directives in 

order to satisfy the requirements. 


Add #63.,R1 ; Round the request 

Asr Rl ; to a 32-word boundary 
Asr R1 ; Then convert the value 
Asr R1 , to the number of 

Asr R1 ; 32-word blocks. 

Asr R1 

Asr Rl 

Mov Rl1,GSAREQ ; Save the real size 


We will allocate core to the pool in "reasonable" 
increments to cut down on system overhead, and pool 
fragmentation. This is accomplished by using either 
the requested size, or "GSAMIN", whichever is LARGER. 
If the request is unsuccessful, and the amount is 
smaller than GSAMIN, then request that particular size. 


Cmp R1,GSAMIN > Smaller than minimum? 
Bhi 40S >; No if HI, use it as is 
Mov GSAMIN,R1L ; Otherwise use GSAMIN 


Now we attempt to extend the task by that size. 
If the request fails, then use the size of the 
original request. If that also fails, then we 
Simply ran out of memory. 


ExtkSS Rl ; Extend the task 


PROGRAMS 


EXAMPLE PROGRAMS 


Bcc 60S ; CC if successful 

Cmp R1,GSAREQ ; Is this request? 

Blos 50S ; Yes if LOS, the end 

Mov GSAREQ,R1 ; Otherwise try to use 

Br 40S ; the actual request 
50S: 

Sec ; Mark failure 

Br 70S * And exit 


The task has been extended, now this memory must be 
released to the pool for future allocation. 

To do this, we setup the registers as if RMS were 
going to release the core, and call ourself to do 

the work. When the area has been released to the 
pool, we will return inline and proceed to reenter 

our code again from start to reattempt the allocation. 


me we we NO TO NO NO TH TO 


60S: 
Mov 4(SP),RO ; Setup the PLH 
Asl R1 ; Convert the real 
Asl RL * size to the actual 
Asl Rl s 16-bit size that 
Asl R1 ; was allocated. 
Asl Rl ; The virtual address 
Asl R1 ; should be after the 
Mov GSABAS , R2 ; task (which is now 
Add R1,GSABAS ; part of the task) 
Call GSA ; Call ourself to release 


At this point, the new memory has been added to the 
pool, and is available for use. We now reattempt 
to allocate the memory required. 


ms ss ws wt we 


Mov (SP) +,R2 ; Restore our registers 
Mov (SP)+,R1l * to the initial state 

Mov (SP) +,R0 ; upon entry, and reenter 
Br GSA ; as if it's a new request 


Common exit. Leave the registers in their current state, 
and return control to the caller. 


me Ne Se we 


705% 
Inc (SP) + ; These won't alter the 
Bit (SP) +,(SP)+ * C-bit, so Status remains 
Return ; unchanged upon return 
.- End 


APPENDIX A 


COMPLETION CODES AND FATAL ERROR CODES 


Section A.1l describes RMS-11 completions that are returned in the STS 
and STV fields of FABs and RABs. Section A.2 describes RMS-11l fatal 
error completions. 


A.1 COMPLETIONS RETURNED IN STS AND STV FIELDS 


This section lists and explains RMS-11 completions that are returned 
in the STS and STV fields of FABs and RABs. For each completion, the 
symbol, message, octal and decimal values, and explanation are given. 


SUSSUC Operation succeeded Octal: 000001 
Decimal: L 
SUSDUP Inserted record has duplicate key Octal: 000002 
Decimal: 2 


The PUT or UPDATE operation inserted a record whose _ key 
duplicates a key already in the index. Note that this 
completion may also be returned if a duplicate of some key in 
the new or updated record ever existed in the file, even if 
that key has since been changed or the record deleted. 


SUSIDX Error updating index Octal: 000003 
Decimal: 3 


The PUT or UPDATE operation inserted the record properly, but 
RMS-1l1 did not optimize the index structure; subsequent 
retrievals of the record will require extra I/O operations. 


ERSACC File access error Octal: 177740 
Decimal: -32 


l. A relative or indexed file is in the initial stage of 
creation and cannot be accessed yet. 2. A write-accessed 
file was not properly closed. 3. The file processor could 
not access the file. The STV field of the FAB contains the 
file processor error code; see your operating system 
documentation for the meaning of the code. 


If the STV field contains a 0, the creation (or block access 
copy) of the relative or indexed file never completed. If the 
STV field contains a nonzero value, that value is a system 
error code indicating the reason the access was rejected. 


COMPLETION CODES AND FATAL ERROR CODES 


ERSACT 


ERSAID 


ERSALN 


ERSALQ 


ERSANI 


ERSAOP 


ERSATR 


ERSATW 


ERSBKS 


ERSBKZ 


Activity precludes operation Octal: 177720 
Decimal: -48 


RMS-11 could not perform the requested operation because of an 
activity in progress (for example, RMS-11 cannot perform the 
CLOSE operation for ae file that has an outstanding 
asynchronous operation). 


Bad value in AID field Octal: 177700 
Decimal: -64 


The file contains no area with the area number given in the 
AID field of an ALL block. 


Bad mask in ALN field Octal: 177660 
Decimal: -80 


The ALN field of an ALL block contains an invalid value. 


Bad value in ALQ field Octal: 177640 
Decimal: -96 


The ALQ field of a FAB or an ALL block contains an invalid 
value; the value in the ALQ field is either too large, or is 
0 for an EXTEND operation. 


Bad ANSI-format magtape file Octal: 177620 
Decimal: -112 
The records in an ANSI-format magtape file are 


variable-length, but are not in the proper ANSI-D format. 


Bad mask in AOP field Octal 177600 
Decimal: -128 


The AOP field of an ALL block contains an invalid mask value. 


Error reading attributes Octal: 177540 
Decimal: -160 


The file processor could not read the attributes for the file. 
The STV field of the FAB or RAB contains the file processor 
error code; see your operating system documentation for the 
meaning of the code. 


Error writing attributes Octal: 177520 
Decimal: -176 


The file processor could not write the attributes for the 
file. The STV field of the FAB or RAB contains the file 
processor error code; see your operating system documentation 
for the meaning of the code. 


Bad value in BKS field Octal: 177500 
Decimal: ~192 


The value in the BKS field of the FAB is too large. 


Bad value in BKZ field Octal: 177460 
Decimal: -208 


The value in the BKZ field of an ALL block is too large; Or 
the bucket sizes of the lowest (LAN) and upper (IAN) areas of 
an index are not equal. 


ERSBOF 


ERSBPA 


ERSBPS 


ERSCCR 


ERSCHG 


ERSCHK 


ERSCLS 


ERS$COD 
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Beginning-of-file found Octal: 177430 
Decimal: -232 


The SPACE operation backspaced to the beginning-of-file. 


Bad address in BPA field Octal: 177420 
Decimal: ~240 


The value in the BPA field of the FAB is odd, and the BPS 
field contains a nonzero value. 


Bad value in BPS field Octal: 177400 
Decimal: -256 


The value in the BPS field of the FAB is nonzero and not a 
multiple of 4, and the BPA field is nonzero. 


RAB already in use Octal: 177340 
Decimal: -288 


The CONNECT operation could not connect a stream using the 
specified RAB because the file is sequential and does not 
allow multiple connected streams. 


Illegal record key change Octal: 177320 
Decimal: -304 


The UPDATE operation did not allow a changed record key 
because the index does not allow key changes or does not allow 
duplicate key values. 


Bad bucket header Octal: 177300 
Decimal: -320 


The bucket header data for an indexed file is corrupted. 


Notify your system manager, who should follow this procedure 
to recover from the error: 


1. Move the disk to a different drive and try the process 


again. If the process succeeds, the error was a hardware 
error; report the faulty hardware and continue 
processing. If the process fails again, proceed to the 


next step. 


2. Recreate the file using an RMS-1ll utility (RMSIFL or 
RMSCNV). If this succeeds, the primary index and data 
records were free of errors and the new file is’ valid; 
continue processing. If this fails, proceed to the next 
step. 


3. Restore the file from a backup copy. 


File processor error Octal: 177260 
Decimal: -336 


The file processor returned an error condition to the CLOSE 
operation. The STV field of the FAB contains’ the file 
processor error code; see your operating system documentation 
for the meaning of the code. 


Bad code in COD field Octal: 177240 
Decimal: -352 


The value in the COD field of an XAB is not valid. 


COMPLETION CODES AND FATAL ERROR CODES 


ERSCRE 


ERSCUR 


ERSDAN 


ERSDEL 


ERSDEV 


ERSDFW 


ERSDIR 


ERSDME 


ERSDNA 


ERSDNF 


File processor error Octal: 177220 

Decimal: -368 
The file processor returned an error condition to the CREATE 
operation. The STV field of the FAB contains the file 


processor error code; 
for the meaning of the code. 


Undefined current-record context Octal: 
Decimal: 

A DELETE, TRUNCATE, or UPDATE operation required a 

current-record context, but it was undefined. 

Bad value in DAN field Octal: 
Decimal: 

The value in the DAN field of a KEY block 


nonexistent area. 


Record having RFA deleted Octal: 
Decimal: 

The record specified by RFA has been deleted. 

Bad device specification Octal: 
Decimal: 


The device specification given contains a syntax error, 
is no such device, the device is inappropriate 

operation, 
RENAME operation. 


File processor error Octal: 
Decimal: 
The file processor returned an error while 


deferred-write data. 


see your operating system documentation 


177200 
-384 


defined 


177140 
-416 


specifies a 


177120 
-432 


177100 
-448 


there 


for the 
or two different devices have been specified for a 


177070 
-456 


writing 
The STV field of the FAB or RAB contains 


the file processor error code; see your operating system 

documentation for the meaning of the code. 

Bad directory specification Octal: 177060 
Decimal: -464 

The directory specification contains a syntax error. 

Pool exhausted Octal: 177040 
Decimal: -480 

One of the five pools that RMS-11 uses cannot provide needed 

space for the operation. 

Bad address in DNA field Octal? 177030 
Decimal: -488 

The DNA field of the FAB contains 0, but the DNS field is 

nonzero. 

No such directory Octal: 177020 
Decimal: -496 

The directory specification given specifies a nonexistent 


directory. 


ERSDNR 


ERSDPE 


ERSDTP 


ERSDUP 


ERSENT 


ERSENV 


ERSEOF 


ERSESA 


ERSESL 


ERSESS 
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Device not ready Octal: 177000 
Decimal: -512 


The device specified is not on line. 


Device positioning error Octal: 176770 
Decimal: -520 


The file processor could not position the magtape device as 
specified. The STV field of the FAB or RAB contains the file 
processor error code; see your operating system documentation 
for the meaning of the code. 


Bad code in DTP field Octal: 176760 
Decimal: -~528 


The value in the DTP field of a KEY block does not specify a 
valid key data type. 


Duplicate key not allowed Octal: 176740 
Decimal: -544 


The record offered for insertion had a record key that would 
duplicate a record already in the index, but the index does 
not allow duplicate keys. 


File processor error Octal: 176720 
Decimal: -560 


The file processor could not create the specified directory 
entry. The STV field of the FAB contains the file processor 
error code; see your operating system documentation for the 
meaning of the code. 


Feature not in selected RMS-11l environment Octal: 176700 
Decimal: -576 


The RMS-11 environment (Selected with the ORGS macro or by the 
compiler or by the manner in which RMS-11 code is linked with 
your program) does not include the attempted operation for the 
specified file organization. 


End-of-file reached Octal: 176660 
Decimal: -592 


The operation specified a record or block that is past the 
last record or block. 


Bad address in ESA field Octal: 176650 
Decimal: -600 


The ESA field of the NAM block contains 0. 


Bad value in ESL field Octal: 176644 
Decimal: ~604 


The ESL field of the NAM block contains 0. 


ESS field value too small Octal: 176640 
Decimal: -608 


The value in the ESS field of the NAM block specifies an 
expanded string buffer that is too small to contain the 
expanded string. 
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ERSEXP 


ERSEXT 


ERSFAC 


ERSFAL 


ERSFEX 


ERSFID 


ERSFLG 


File expiration date not yet reached Octal: 176630 
Decimal: -616 
File processor error Octal: 176620 
Decimal: -624 


The file processor could not make the requested extension to 
the file. The STV field of the FAB or RAB contains the file 
processor error code; see your operating system documentation 
for the meaning of the code. 


FAC field forbids operation Octal: 176560 
Decimal: -656 


The attempted record or block operation was not specified in 
the FAC field of the FAB when the file was created or opened. 


Operation not supported by remote node Octal: 176550 
Decimal: -664 


The remote node for a remote RMS-11 operation does not support 
that operation. The STV field of the FAB or RAB contains (in 
its high 4 bits) a code that gives the reason for the error: 


@e 0O--Incompatible operating systems; the low 12 bits of the 
STV field contain the type of the remote operating system 


e 1--Incompatible file systems; the low 12 bits of the STV 
field contain the type of the remote file system 


@e 2--DAP version number smaller than 5; the low 12 bits of 
the STV field contain the DAP version number 


@e 3--DAP modification number smaller than 6; the low 12 bits 
of the STV field contain the DAP modification number 


e 4--Unsupported file organization 
e 5--Unsupported record access 


e 6--Operation not Supported by FAL; the low 12 bits of the 
STV field contain the operation code 


@e 7--Remote I/O buffer too small; the low 12 bits contain 
the size of the remote I/0 buffer 


File already exists Octal: 176540 
Decimal: -672 
The file specified for creation already exists, but 


supersession was not specified. 


Bad value in FID field Octal: 177530 
Decimal: ~680 


The FID field of the NAM block contains a value that is not a 
file identifier. 


Bad mask in FLG field Octal: 176520 
Decimal: -688 


The combination of masks specified in the FLG field of a KEY 
block is illegal. 


ERSFLK 


ERSFNA 


ERSFND 


ERSFNF 


ERSFNM 


ERSFOP 


ERSFUL 


ERSIAN 


ERS IDX 


ERSIFI 
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File locked by another task Octal: 176500 
Decimal: -704 


The file sharing specified is not allowed by a task already 
accessing the file. 


Bad address in FNA field Octal: 176470 
Decimal: -712 


The FNA field of the FAB contains 0, but the FNS field is 
nonzero. 


File processor error Octal: 176460 
Decimal: -720 


The file processor could not find the file specified. The STV 
field of the FAB contains the file processor error code; see 
your operating system documentation for the meaning of the 
code. 


File not found Octal: 176440 
Decimal: -~736 


The file specified for a directory or file operation does not 
exist. 


Bad file name Octal: 176420 
Decimal: -752 


The file name portion of a file specification string has a 
syntax error. 


Bad mask in FOP field Octal: 176400 
Decimal: -768 


The FOP field of the FAB contains one or more illegal masks. 


Device or file full Octal: 176360 
Decimal: -784 


The specified device or file has no room to allow file 
creation or extension. 


Bad value in IAN field Octal: 176340 
Decimal: -800 


The value in the IAN field of a KEY block specifies a 
nonexistent file area. 


Index not initialized Octal: 176320 
Decimal: ~816 


This code is only returned in the STV field of the RAB in 
conjunction with the code ERSRNF in the STS field. It 
indicates that no entries have been made in the index 
specified for the GET or FIND operation. 


Bad value in IFI field Octal: 176300 
Decimal: -832 


The value in the IFI field of the FAB is not the internal file 
identifier for a file. 
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ERS IMX 


ERSIOP 


ERSIRC 


ERSISI 


ERS KBF 


ERSKEY 


ERSKRF 


ERSKSZ 


ERSLAN 


ERSLBL 


Too many XABs of same type Octal: 176260 
Decimal: -848 


The number of XABs of the same type in the chain of XABs is 
too large (more than 254 ALL blocks or KEY blocks, more than 1 
DAT block, PRO block, or SUM block). 


Illegal operation for file Octal: 176220 
Decimal: -880 


The requested operation is illegal for the file organization 
or for the allowed access. 


Illegal record found in sequential file Octal: 176200 
Decimal: -896 


The record length field of a record in a sequential file is 
invalid. 


Bad value in ISI field Octal: 176160 
Decimal: -912 


The ISI field of the RAB contains a value that is not an 
internal stream identifier. 


Bad address in KBF field Octal: 176140 
Decimal: -928 


The KBF field of the RAB contains 0. 


Bad key Octal: 176120 
Decimal: -944 


The key specified for a key access operation is invalid 
(either a negative RRN or an erroneous packed-decimal key). 


Bad value in KRF field Octal: 176100 
Decimal: -960 


The KRF field of the RAB contains (or contained) a value that 
does not specify a file index. For a key access FIND or GET 
Operation, the RAB contains the invalid value in its KRF 
field; for a sequential access FIND or GET operation, the RAB 
contained the invalid value in its KRF field during an earlier 
CONNECT or REWIND operation. 


Bad value in KSZ field Octal: 176060 
Decimal: ~976 


The KSZ field of the RAB contains an invalid value. 


Bad value in LAN field Octal: 176040 
Decimal: -992 


The value in the LAN field of a KEY block specifies a 
nonexistent file area. 


Bad magtape label Octal: 176020 
Decimal: -1008 


The magtape does not have a valid ANSI label. 


ERSLBY 


ERSLCH 


ERSLEX 


ERS$LOC 


ERSMEM 


ERSMKD 


ERSMRN 


ERSMRS 
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Logical channel busy Octal: 176000 
Decimal: -1024 


The LCH field of the FAB contains the number of a logical 
channel that is already in use by the task. 


Bad value in LCH field Octal: 175760 
Decimal: -1040 


The LCH field of the FAB contains a value that is too large to 
be a logical channel number. 


Extension not needed Octal: 175750 
Decimal: -1048 


The requested extension was not needed because the file area 
still contains an unused extent. 


Bad value in LOC field Octal: 175740 
Decimal: -1056 


The LOC field of an ALL block contains a value that does not 
specify a valid location. 


Memory address rollover Octal: 175710 
Decimal: -1080 


The area specified for the file string, default string, 
expanded string, or resultant string extends beyond the end of 
addressable memory. 


File processor error Octal: 175700 
Decimal: -1088 


The file processor could not mark the specified file for 
deletion. The STV field of the FAB contains the file 
processor error code; see your operating system documentation 
for the meaning of the code. 


Bad value in MRN field or bad record number Octal: 175660 
Decimal: -1104 


The MRN field of the FAB contains a negative number (CREATE 
operation), or the record number specified for a key access 
record operation is larger than the file maximum record number 
(specified in the MRN field at file creation). 


Bad value in MRS field Octal: 175640 
Decimal: -1120 


The MRS field of the FAB contains 0 even though the file to be 
created is requested either to be a relative file or to have 
fixed-length records. 
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ERSNAE 


ERSNAM 


ERSNEF 


ERSNET 


ERSNMF 


ERSNOD 


ERSNPK 


ERSORD 


ERSORG 


Unmappable network access error Octal: 175630 
Decimal: -1128 


If this error occurs, please submit a Software Performance 
Report to DIGITAL, including the following information: 


e Contents of general registers and stack 


@e Operation and file organization for which the error 
occurred 


e Task builder map of the task 
@e Post-mortem dump 


Bad address in NAM field Octal: 175620 
Decimal: -1136 


The NAM field of the FAB contains 0 or an odd address. 


Context not end-of-file Octal: 175600 
Decimal: -1152 


The PUT operation could not insert a record into a sequential 
file because the next-record context was not the end-of-file. 


Network link lost Octal: 175570 
Decimal: -1160 


The STV field of the FAB or RAB contains the network error 
code. 


No more matching files Octal: 175554 
Decimal: -1172 


The SEARCH operation ended the wildcard SEARCH series because 
there are no more files matching the wildcard file 
specification. 


Bad node name Octal: 175550 
Decimal: -1176 


The specified node name is invalid or, for the RENAME 
operation, the two node names are different. 


No primary key for indexed file Octal: 175540 
Decimal: -1184 


The CREATE operation did not create the specified file because 
no primary index was specified even though the request 
specified indexed file organization. 


Ordering of XABs illegal Octal: 175500 
Decimal: -1216 


The chain of xXABs for a directory or file operation is 
improperly ordered. 


Bad mask in ORG field Octal: 175460 
Decimal: -1232 


The ORG field of the FAB contains an invalid file organization 
code; the file was not created. 


ERS PLG 


ERSPLV 


ERSPOS 


ERS PRM 


ERSPRV 


ERSRAC 


ERSRAT 


ERS RBF 
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Error reading file prologue Octal: 175440 

Decimal: -1248 
The data read from the file prologue is incorrect. 


Notify your system manager, who should follow this procedure 
to recover from the error: 


1. Move the disk to a different drive and try the process 


again. If the process succeeds, the error was a hardware 
error; report the faulty hardware and continue 
processing. If the process fails again, proceed to the 


next step. 


2. Recreate the file using an RMS-1ll utility (RMSIFL or 
RMSCNV). If this succeeds, the primary index and data 
records were free of errors and the new file is valid; 
continue processing. If this fails, proceed to the next 
step. 


3. Restore the file from a backup copy. 


File prologue version level unsupported Octal: 175430 
Decimal: -1256 


The file prologue version number shows that the file was 
created by a version of RMS that is not supported on your 
system. 


Bad value in POS field Octal: 175420 
Decimal: ~1264 


The POS field of a KEY block contains a value that is greater 
than the maximum record size for the file; the STV field of 
the FAB contains the address of the KEY block. 


Bad file date read Octal: 175400 
Decimal: -1280 


The file dates read are illegal. 


Privilege violation Octal: 175360 
Decimal: -1296 


The file processor denied the requested operation because the 
task has no privilege for the operation. 


Bad mask in RAC field Octal: 175320 
Decimal: -1328 


The RAC field of the RAB contains an illegal value. 


Bad mask in RAT field Octal: 175300 
Decimal: -1344 


The RAT field of the FAB contains illegal set bits. 


Bad address in RBF field Octal: 175260 
Decimal: -1360 


The RBF field of the RAB contains an odd address; the address 
must be even for block access. 
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ERSRER 


ERS REX 


ERSRFA 


ERSRFM 


ERSRLK 


ERS RMV 


ERS RNF 


ERSRNL 


ERS$ROP 


File processor error Octal: 175240 
Decimal: -1376 


The file processor could not read the requested record or 
block. The STV field of the FAB or RAB contains the file 
processor error code; see your operating system documentation 
for the meaning of the code. 


Record already exists Octal: L75220 
Decimal: -1392 


The target cell for a PUT operation to a relative file already 
contains a record. 


Bad value in RFA field Octal: 175200 
Decimal: -1408 


The RFA field of the RAB contains an illegal RFA. 


Bad code in REM field Octal: 175160 
Decimal: -1424 


The RFM field of the FAB contains an illegal value. 


Record locked Octal: 175140 
Decimal: -1440 


The bucket containing the specified record is locked by 
another task or by another stream in your task. 


File processor error Octal: 175120 
Decimal: -1456 


The file processor could not delete the specified directory 
entry. The STV field of the FAB contains the file processor 


error code; see your operating system documentation for the 
meaning of the code. 


No such record Octal: 175100 
Decimal: ~1472 


The record specified for key access does not exist. 


Record not locked Octal: 175060 
Decimal: -1488 


The FREE operation found that no record was locked for. the 
stream. 


Bad mask in ROP field Octal: 175040 
Decimal: -1504 


The ROP field of the RAB contained illegal set bits. 


ERSRPL 


ERSRRV 


ERSRSL 


ERSRSS 


ERSRST 


ERSRSZ 


ERSRTB 
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File processor error Octal: 175020 
Decimal: -1520 

The data read from the file prologue is incorrect. 


Notify your system manager, who should follow this procedure 
to recover from the error: 


1. Move the disk to a different drive and try the process 


again. If the process succeeds, the error was a hardware 
error; report the faulty hardware and continue 
processing. If the process fails again, proceed to the 


next step. 


2. Recreate the file using an RMS-11 utility (RMSIFL or 
RMSCNV). If this succeeds, the primary index and data 
records were free of errors and the new file is valid; 
continue processing. If this fails, proceed to the next 
step. 


3. Restore the file from a backup copy. 


Bad internal pointer Octal: 175000 
Decimal: -1536 


An internal pointer in the file is invalid. Reload the file, 
with RMSCNV or RMSIFL, using its primary index. 


Bad value in RSL field Octal: 174754 
Decimal: -1556 


The RSL field of the NAM block contains 0. 


Bad value in RSS field Octal: 174750 
Decimal: -1560 


The RSS field of the NAM block contains 0. 


Bad address in RSA field Octal: 174744 
Decimal: -1564 


The RSA field of the NAM block contains 0. 


Bad value in RSZ field Octal: 174740 
Decimal: -1568 


The RSZ field of the RAB contains a value that is larger than 
the maximum allowed record size, or {for fixed-length records) 
is not equal to the maximum record size, or (for an UPDATE 
Operation to a sequential file) is not equal to the length of 
the record to be updated. 


Record too big for user buffer Octal: 174720 
Decimal: -1584 


The record read cannot fit into the user buffer; the STV 
field of the RAB contains the size of the record, and the 
portion that will fit is moved to the user buffer as for a 
successful GET. 
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ERSRVU Internal pointer corrupted Octal: 174710 
Decimal: -1592 


The record insertion succeeded and the primary index was 
updated successfully; however, RMS-11 could not update 
internal pointers. 


To recover from the error, follow this procedure: 
l. Recreate the file using an RMS-11 utility (RMSIFL or 


RMSCNV) . If this succeeds, the primary index and data 
records were free of errors and the new file is valid; 


continue processing. If this fails, proceed to the next 
step. 
2. Restore the file from a backup copy. 
ERSSEQ Sequential insertion records not in order Octal: 174700 
Decimal: -1600 


The sequential access PUT operation found records whose 
primary keys were not in ascending order. 


ERSSHR Bad mask in SHR field Octal: 174660 
Decimal: -1616 


The SHR field of the FAB contains an illegal mask. 


ERSSIZ Bad value in SIZ field Octal: 174640 
Decimal: -1632 


The SIZ field of a KEY block contains an illegal value. 


ERSSUP Operation not supported over network Octal: 174610 
Decimal: -1656 


The requested operation is not supported over the network. 


ERSSYS System error Octal: 174600 
Decimal: -1664 
The interface between RMS-11 and the system is in error; the 
STV field of the FAB or RAB contains the status code for a 
system directive. Please submit a Software Performance 
Report. 
ERSTRE Index error Octal: 174560 
Decimal: -1680 
The index contains invalid data. Build a new file using 


either an RMS-11l utility (RMSIFL or RMSCNV) or _ uSing 
sequential access and the primary index to fetch the old 
records. 


ERSTYP Bad file type Octal: 174540 
Decimal: -1696 


The file type in a file specification contains invalid syntax. 


ERSUBF Bad address in UBF field Octal: 174520 
Decimal: -1712 


The UBF field of the RAB contains 0 or, for block access, an 
odd address. 


A-14 


ERSUIN 


ERSUSZ 


ERSVER 


ERSWCD 


ERSWER 


ERSWLK 


ERSWPL 


ER$XAB 


ERSXTR 
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Field value rejected by FAL Octal: 174510 
Decimal: -1720 


The FAL (file access listener) rejected the value in a control 
block field; the STV field of the FAB or RAB contains a code 
showing which field. See your DECnet documentation for the 
meanings of these codes. 


Bad value in USZ field Octal: 174500 
Decimal: -1728 


The USZ field of the RAB contains 0. 


Bad file version number Octal: 174460 
Decimal: -1744 


The file version portion of a file specification contains a 
syntax error. 


Illegal wildcard in merged string Octal: 174430 

Decimal: -1768 
The merged string contains a wildcard character, but 
wildcarding is not in progress or is illegal for the 


operation. 


File processor error Octal: 174420 
Decimal: -1776 


The file processor could not write to the file. The STV field 
of the FAB or RAB contains the file processor error code; see 
your operating system documentation for the meaning of the 
code. 


Device write-locked Octal: 174410 
Decimal: -1784 


The device specified is write-locked. 


File processor error Octal: 174400 
Decimal: -1792 


The file processor could not write the file prologue. The STV 
field of the FAB or _ RAB contains the file processor error 
code; see your operating system documentation for the meaning 
of the code. 


Bad address in XAB field Octal: 174360 
Decimal: -1808 


The XAB field of the FAB contains an odd address. 


Extraneous data in file specification Octal: 174340 
Decimal: -1824 


The file specification contains extraneous’ characters. The 
value in the STV field of the FAB is the address of the first 
character beyond the end of the valid file specification. 
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A.2 FATAL ERROR COMPLETIONS 


This section lists and explains RMS-11 completions that are returned 
in general register RO. These errors are fatal either because RMS-11 
detected an internal error condition and could not continue, or 
because the RAB or FAB is of questionable validity and RMS-11 
therefore did not write the completion in its fields. 


ERSACT Illegal concurrent operation Octal: 177720 
Decimal: -48 


1. The FAB you specified is already in use by another 
operation. 2s You have illegally interrupted RMS-11 
processing. 


ERSAST Illegal operation at AST level Octal: 177560 
Decimal: -144 


Your program attempted to use WAIT operation at AST level. 


ERSBUG' Error in RMS-11 internal data Octal: 177360 
Decimal: -272 


RMS-11 detected an error in its internal data structures. The 
error may have been caused by your task writing into the 
structures; if you think your task did not cause the error, 
please submit a Software Performance Report to DIGITAL, 
including the following information: 


e Contents of general registers and stack 


e Operation and file organization for which the error 
occurred 


e Task builder map of the task 
e Post-mortem dump 


ERSCPB Bad parameter block Octal: 177230 
Decimal: -360 


The parameter block (pointed to by R5) for an operation macro 
has an invalid argument count or is at a zero or odd address. 


ERSFAB' Bad FAB Octal: 176600 
Decimal: -640 


The value in the BID or BLN field of the specified FAB is. not 
the correct identifier or block length for a FAB, or the 
address of the FAB is 0 or odd. 


ERSLIB Resident library not available Octal: 175744 
Decimal: -1052 


The version of the RMS-11 resident library needed for your 
task is not available. 


ERSMAP 


ERS RAB 
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Error in internal buffer mapping data Octal: 175720 
Decimal: -1072 


RMS-l11 detected an error in its internal data structures. The 
error may have been caused by your task writing into the 
structures; if you think your task did not cause the error, 
please submit a Software Performance Report to DIGITAL, 
including the following information: 


# Contents of general registers and stack 


@ Operation and file organization for which the error 
occurred 


@e Task builder map of the task 
® Post-mortem dump 


Bad RAB Octal: 175340 
Decimal: -1312 


The value in the BID or BLN field of the specified RAB is not 
the correct identifier or block length for a RAB, or the 
address of the RAB is 0 or odd. 


APPENDIX B 


ASSEMBLY-TIME MESSAGES 


RMS-11 macros detect some errors during assembly. For each such 
error, the macro issues a .PRINT or .ERROR assembler directive with a 
message. This appendix shows these messages and their meanings. 


SCOMPARE MACRO - FIELD TOO LARGE 


You can specify only a 1-byte or 1l-word field as the field 
parameter for the SCOMPARE macro. 


SCOMPARE MACRO - FIELD PARAMETER INVALID 


You must specify a valid field mnemonic as the field parameter 
for the SCOMPARE macro. 


SFETCH MACRO - PC DESTINATION INVALID 


You cannot specify the PC as the destination for the SFETCH 
macro. 


SFETCH OR SSTORE MACRO — ADDRESS MODE INVALID 
You have used an illegal address mode in the source for a SSTORE 
macro or in the destination for a SFETCH macro. See Chapter 3 
for a description of legal address modes for these macros. 


SFETCH OR SSTORE MACRO - FIELD PARAMETER INVALID 


You can specify only a valid field mnemonic as the field 
parameter for a field access macro. 


SFETCH OR SSTORE MACRO - FIELD TOO LARGE FOR GIVEN REGISTERS 
You. cannot specify the given register as_ the source or 
destination address because the field is larger than the 
remaining registers. 


SFETCH OR SSTORE MACRO - FIELD TOO LARGE FOR IMMEDIATE MODE 


You can specify an immediate mode value for a field access macro 
only if you specify a l-byte or l-word field. 


SFETCH OR SSTORE MACRO - FIELD TOO LARGE FOR REGISTERS 


You cannot specify a register as the source or destination 
address because the given field is too large. 
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SFETCH OR SSTORE MACRO - REGISTER 


PARAMETER INVALID 


You can specify only RO, Rl, 
Parameter for a field access 


R2, R3, 
macro. 


R4, or R5 


SFETCH OR SSTORE MACRO - REGISTER USAGES OVERLAP 
You cannot specify the given register as 
destination address 


register containing the control block address. 


as the register 


the source or 


because the indicated registers overlap the 


SOFF MACRO —- FIELD TOO LARGE 
You can specify only a 1-byte or I1l-word field as the field 
parameter for the SOFF macro. 

SOFF MACRO - FIELD PARAMETER INVALID 
You must specify a valid field mnemonic as the field parameter 
for the SOFF macro. 

SSET MACRO —- FIELD TOO LARGE 
You can specify only a 1-byte or 1l-word field as the field 
parameter for the SSET macro. 

SSET MACRO - FIELD PARAMETER INVALID 
You must specify a valid field mnemonic as the field parameter 
for the SSET macro. 

SSETGSA MACRO - REGISTER PARAMETER INVALID 
You must specify RO, Rl, R2, R3, R4, or R5 as the register 
Parameter for the SSETGSA macro. 

STESTBITS MACRO - FIELD TOO LARGE 
You can specify only a 1l-byte or 1l-word field as the field 
Parameter for the STESTBITS macro. 

STESTBITS MACRO ~- FIELD PARAMETER INVALID 
You must specify a valid field mnemonic as the field parameter 
for the STESTBITS macro. 

FSBSZ MACRO - BSZ FIELD NOT USED IN RMS-11 
RMS-1ll has no BSZ field in the FAB; therefore the FSBSZ macro 
cannot initialize the field. 

FSJFN MACRO ~ JFN FIELD NOT USED IN RMS-11 
RMS-11 has no JFN field in the FAB; therefore the FSJFN macro 
Cannot initialize the field. 


FABSB MACRO 


FABSB MACRO 


- ALREADY IN BLOCK OR POOL DECLARATION 


You cannot use the FABSB macro to begin FAB declaration until you 


block or 
RABSE or XABSE macro). 


the current 
POOLSE, 


ended 
NAMSE, 


have 
FABSE, 


- FAB NOT WORD-ALIGNED 
Use the 


assures word-alignment for the FAB. 


B-2 


pool declaration 


~EVEN assembler directive before the FABSB 


(using the 


macro; this 
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FABSE MACRO - NOT IN FAB DECLARATION 


You must begin a FAB declaration with the FABSB macro before 
ending it with a FABSE macro. 


NAMSB MACRO - ALREADY IN BLOCK OR POOL DECLARATION 
You cannot use the NAMSB macro to begin NAM block declaration 
until you have ended the current block or pool declaration (using 
the FABSE, NAMSE, POOLSE, RABSE or XABSE macro). 

NAMSB MACRO ~- NAM BLOCK NOT WORD-ALIGNED 


Use the .EVEN assembler directive before the NAMSB macro; this 
assures word-alignment for the NAM. 


NAMSE MACRO - NOT IN NAM BLOCK DECLARATION 


You must begin a NAM block declaration with the NAMSB- macro 
before ending it with a NAMSE macro. 


OPERATION MACRO - FAB OR RAB ADDRESS PARAMETER MISSING 
You must specify a control block address for the operation macro; 
for a file operation, specify a FAB address; for a stream, 
record, or block I/O operation, specify a RAB address. 


ORGS MACRO - OPERATION PARAMETER INVALID 


You can specify only CRE, DEL, FIN, GET, PUT, and UPD as 
operation parameters for the ORGS macro. 


ORGS MACRO - ORGANIZATION PARAMETER INVALID 


You can specify only IDX, REL, or SEQ as the organization 
parameter for the ORGS macro. 


ORGS MACRO - ORGANIZATION PARAMETER MISSING 


You must specify IDX, REL, or SEQ as the organization parameter 
for the ORGS macro. 


POOLSB MACRO —- ALREADY IN BLOCK OR POOL DECLARATION 
You cannot use the POOLSB macro to begin pool declaration until 
you have ended the current block or pool declaration (using the 
FABSE, NAMSE, POOLSE, RABSE or XABSE macro). 

POOLSE MACRO - NOT IN POOL DECLARATION 


You must begin a POOL declaration with the POOLSB macro before 
ending it with a POOLSE macro. 


RSLSN MACRO - LSN FIELD NOT USED IN RMS-11 


RMS-11 has no LSN field in the RAB; therefore the RSLSN macro 
cannot initialize the field. 


RABSB MACRO - ALREADY IN BLOCK OR POOL DECLARATION 
You cannot use the RABSB macro to begin RAB declaration until you 


have ended the current block or pool declaration (using the 
FABSE, NAMSE, POOLSE, RABSE or XABSE macro). 


ASSEMBLY-TIME MESSAGES 


RABSB MACRO - RAB NOT WORD-ALIGNED 


Use the .EVEN assembler directive before the RABSB macro; this 
assures word-alignment for the RAB. 


RABS$B MACRO - RAB TYPE PARAMETER INVALID 


You can specify only SYN, ASYN, or a null as the parameter for 
the RABSB macro. 


RABSE MACRO - NOT IN RAB DECLARATION 


YOu must begin a RAB declaration with the RABSB macro. before 
ending it with a RABSE macro. 


XSSIZ MACRO - TOTAL KEY SIZE TOO LARGE 


The sum of the segment sizes for a key is greater than 255. 
Specify smaller segments. 


XABSB MACRO - ALREADY IN BLOCK OR POOL DECLARATION 
YOu cannot use the XABSB macro to begin XAB declaration until you 
have ended the current block or _ pool declaration (using the 
FABSE, NAMSE, POOLSE, RABSE or XABSE macro). 

XABSB MACRO - XAB NOT WORD-ALIGNED 


Use the .EVEN assembler directive before the XABSB macro; this 
assures word-alignment for the XAB. 


XABSB MACRO - XAB TYPE PARAMETER INVALID 


You can specify only XBSALL, XBSDAT, XBSKEY, XBSPRO, or XBSSUM as 
the XAB type parameter for the XABSB macro. 


XABSE MACRO - NOT IN XAB DECLARATION 


You must begin a XAB declaration with the XABSB macro before 
ending it with a XABSE macro. 


APPENDIX C 


MACROS THAT DECLARE SYMBOLS AND OTHER MACROS 


Table C-l lists RMS-1l macros (and their arguments) that declare 
symbols and other macros. In the table, the expression xxx represents 
a 2- or 3-character string, so that the expression OSxxx represents 
all symbols that begin with OS; the expression fld represents a field 
mnemonic. 


Note that you can declare symbols either globally or locally. For a 
FABSBT, RABSBT, XABSBT, or SRMSTAT macro, give the argument DFINSG (or 
omit the argument) to define symbols globally; give the argument 
DFINSL to define symbols locally. 


Note also that you can declare symbols for control block sizes without 
declaring field-offset symbols. For a FABOFS, NAMOFS, RABOFS, XABOFS, 
XBAOFS, XBDOFS$, XBKOFS, XBPOFS, or XBSOFS$ macro, give the argument 
DEFSSZ to define only symbols for block sizes, or give no argument to 
define both symbols for block sizes and field-offset symbols. 


Table C-1l: Macros That Declare Symbols and Other Macros 


Macro Argument Declares 
FABSB - FAB field-initialization macros: of the form 
FSfld 


- FAB end-block-declaration macro: FABSE 
- FAB field-offset symbols: of the form OSfld 
- FAB code and mask symbols: of the form 


FBSxxx 

FABSBT DFINSG - Global FAB code and mask symbols: of the 
form FBSxxx (except FAB length symbol 
FBSBLN) 

FABSBT DFINSL - Local FAB code and mask symbols: of the form 


FBSxxx (except FAB length symbol FBSBLN) 


FABOFS - FAB field offset symbols: of the form OSfld 
~ FAB length symbol: FBSBLN 


FABOFS DEFSSZ - FAB length symbol: FBSBLN 


(Continued on next page) 


MACROS THAT DECLARE SYMBOLS AND OTHER MACROS 


Table C-1 (Cont.): Macros That Declare Symbols and Other Macros 


Macro Argument Declares 
SFBCAL - Directory operation macros: SENTER, SPARSE, 
SREMOVE, SRENAME, and SSEARCH 
- File operation macros: SCLOSE, SCREATE, 
SDISPLAY, SERASE, SEXTEND, and SOPEN 
SGNCAL - Get-space address macros: GSAS, SGETGSA, and 


SSETGSA 


- Facilities-declaration macro: 
- RMS-11 initialization 


SINITIF (obsolete) 
- Field-access macros: 


SCOMPARE, 


macros: 


SSET, SSTORE, and STESTBITS 
- Completion-handler return macro: 


NAMSB ~ NAM block field-initialization 


the form NSfld 


ORGS 


SINIT and 


SFETCH, SOFF, 


SRETURN 


macros: of 


- NAM block end-block-declaration macro: NAMSE 
- NAM block field-offset symbols: of the form 


OSfld 


- NAM block code and mask symbols: 


NBSxxx 


NAMOFS - NAM block field offset symbols: 


Osfl1d 


- NAM block length symbol: NBSBLN 


NAMOFS DEFSSZ - NAM block length symbol: NBSBLN 


POOLSB - Pool declaration macros: 


PSFAB, PSIDX, PSRAB, 


of the form 


of the form 


PSBDB, PSBUF, 
and PSRABX 


- End-pool-declaration macro: POOLSE 
RABSB -~ RAB field-initialization macros: of the form 
RSfld 
- RAB end-block-declaration macro: RABSE 
- RAB field-offset symbols: of the form OSfld 
- RAB code and mask symbols: of the form 
RBSxxx 
RABSBT DFINSG ~ Global RAB code and mask symbols: of the 


form RBSxxx (except RAB length symbol RBSBLN 


of the form 


or RBSBLL) 

RABSBT DFINSL - Local RAB code and mask symbols: 
RBSxxx (except RAB length symbol RBSBLN or 
RBSBLL) 

RABOFS - RAB field offset symbols: of the 


- RAB length symbol: RBSBLN (for 
RAB) or RBSBLL (for asynchronous 


RABOFS DEFSSZ - RAB length symbol: RBSBLN (for 
RAB) or RBSBLL (for asynchronous 


(Continued 


form OSfld 
synchronous 
RAB) 


synchronous 
RAB) 


on next page) 


MACROS THAT DECLARE SYMBOLS AND OTHER MACROS 


Table C-1 (Cont.): Macros That Declare Symbols and Other Macros 


Macro Argument Declares 
SRBCAL - Stream operation macros: SCONNECT, 
SDISCONNECT, SFLUSH, SFREE, SNXTVOL, 


SREWIND, and SWAIT 

- Record operation macros: S$DELETE, SFIND, 
SGET, SPUT, STRUNCATE, and SUPDATE 

- Block operation macros: S$READ, S$SPACE, and 
SWRITE 


SRMSTAT DFINSG - Global completion symbols: of the forms 
ERSxxx and SUSxxx 


SRMSTAT DFINSL - Local completion symbols: of the forms 
ERSxxx and SUSxxx 


XABSB XBSALL - ALL block field-initialization macros: of 
the form XSfld 
- XAB end-block-declaration macro: XABSE 
- ALL block field-offset symbols: of the form 


OSsfld 
- XAB code and mask symbols: of the form 
XBSxxx 
XABSB XBSDAT - DAT block field-initialization macros: of 


the form XSfld 
- XAB end-block-declaration macro: XABSE 
- DAT block field-offset symbols: of the form 


Osfld 
- XAB code and mask symbols: of the form 
XBSxxx 
XABSB XBSKEY - KEY block field-initialization macros: of 


the form XSfld 
- XAB end-block-declaration macro: XABSE 
- KEY block field-offset symbols: of the form 


OSfl1d 
- XAB code and mask symbols: of the form 
XBSxxx 
XABSB XBSPRO - PRO block field-initialization macros: of 


the form XSfld 
- XAB end-block-declaration macro: XABSE 
- PRO block field-offset symbols: of the form 


OSfld 
- XAB code and mask symbols: of the form 
XBSxxx 
XABSB XBSSUM - SUM block field-initialization macros: of 


the form XSfld 

- XAB end-block-declaration macro: XABSE 

- SUM block field-offset symbols: of the form 
OSfld 

- XAB code and mask symbols: of the form 
XBSxxx 


(Continued on next page) 


MACROS THAT DECLARE SYMBOLS AND OTHER MACROS 


Table C-1l1 (Cont.): Macros That Declare Symbols and Other Macros 


Macro Argument 
XABSBT DFINSG 
XABSBT DFINSL 
XABOFS 

XABOFS DEFSSZ 
XBAOFS 

XBAOFS DEFSSZ 
XBDOFS$ 

XBDOFS DEFSSZ 
XBKOFS 

XBKOFS DEFSSZ 
XBPOFS 

XBPOFS DEFSSZ 
XBSOFS 

XBSOFS DEFSSZ 


Declares 


- Global XAB code and mask symbols: of the 
form XBSxxx (except XAB length’ symbols: 
XBSLAL, XBSDTL, XBSKYL, XBSPRL, and XBSSML) 


~ Local XAB code and mask symbols: of the form 
XBSxxx (except XAB length symbols: XBSLAL, 
XBSDTL, XBSKYL, XBSPRL, and XBSSML) 


- XAB field offset symbols: of the form OSfld 


- XAB length symbols: XBSLAL, XBSDTL, XBSKYL, 
XBSPRL, and XBSSML 
- XAB length symbols: XBSLAL, XBSDTL, XBSKYL, 


XBSPRL, and XBSSML 


- ALL block field offset symbols: of the form 
OSfld 

- ALL block length symbol: XBSLAL 

- ALL block length symbol: XBSLAL 

- DAT block field offset symbols: of the form 
OSfld 

- DAT block length symbol: XBSDTL 

- DAT block length symbol: XBSDTL 

- KEY block field offset symbols: of the form 
OSfld 

- KEY block length symbol: XBSKYL 

- KEY block length symbol: XBSKYL 

- PRO block field offset symbols: of the form 
OSsfld 

- PRO block length symbol: XBSPRL 

- PRO block length symbol: XBSPRL 

- SUM block field offset symbols: of the form 


OSfld 
- SUM block length symbol: XBSSML 


- SUM block length symbol: XBSSML 


APPENDIX D 


RMS-11 WITH DIFFERENT OPERATING SYSTEMS 


This appendix contrasts the behaviors of RMS-11 on different operating 
systems: 


@ PRO/RMS-11 versus RSTS/E RMS-11 
@ PRO/RMS-11 versus RSX-11M/M-PLUS RMS-1l1 


e RSTS/E RMS-11 versus RSX-11M/MPLUS RMS-11 


D.1 PRO/RMS-11 VERSUS RSTS/E RMS-11 


This section contrasts the behaviors of PRO/RMS-11 and RSTS/E RMS-11l. 


D.1.1 Different Behaviors 
The following features behave differently for RSTS/E and P/OS users: 
@e Macro library location 


RMS-11 macro libraries for the systems are located in the 
files: 


RSTS/E LB: RMSMAC.MLB 
P/OS LB: [1,1] RMSMAC.MLB 


e RTV field in FAB 
The RTV field in the FAB has different uses: 


RSTS/E Cluster size 
P/OS Retrieval pointer count 


e Maximum bucket size 


The maximum bucket sizes (given by the BKS field in the FAB or 
the BKZ fields in ALL blocks) are different: 


RSTS/E 15 blocks 
P/OS 32 blocks 


RMS-11 WITH DIFFERENT OPERATING SYSTEMS 


e Area alignment 


The meanings of area alignment codes (in the ALN field of an 
ALL block) are different: 


RSTS/E XBSLBN Cluster alignment 

P/OS XBSCYL Cylinder alignment 
XBSLBN Logical block alignment 
XBSVBN Virtual block alignment 


e Protection codes 


The protection codes (and defaults) are system-specific. 


D.1.2 Features Not Supported on RSTS/E 


The following RMS-11l features are not supported on RSTS/E, but are 
supported on P/OS: 


e ENTER operation (SENTER macro) 

@e NXTVOL operation (SNXTVOL macro) 

@ REMOVE operation (SREMOVE macro) 

e SPACE operation (SSPACE macro) 

e WAIT operation (SWAIT macro) 

e User-provided interlocking (FBSUPI mask in SHR field of FAB) 

e File version numbers (NBSVER mask in FNB field of NAM) 

e Asynchronous execution of operations (RBSASY mask in ROP field 
of RAB; SYN and ASYN arguments to RABSB macro; RBSBLL symbol 
for length of asynchronous RAB) 

® Directories (DID field in NAM block) 


e Area extension (ALL block fields for SEXTEND macro) 


e Contiguous file extension (FBSCTG mask in FOP field of FAB for 
SEXTEND macro) 


e Hard placement (XBSHRD mask in AOP field of ALL block) 


@e Return of date and protection information by DISPLAY operation 
(PRO block fields and DAT block fields for SDISPLAY macro) 


e File expiration date (EDT field of NAM block) and “file 
revision number (RVN field of NAM block) 


D.1.3 Features Not Supported on P/OS 


On RSTS/E, for compatibility with older file system, RMS-ll treats 
certain sequential files with undefined records as sequential files 
with stream records. P/OS will allow only block access to such files. 
In addition, magtape devices are not supported on P,vUS, and remote 
operations are not supported on P/OS. 


RMS-11 WITH DIFFERENT OPERATING SYSTEMS 


D.2 PRO/RMS-11 VERSUS RSX-11M/M-PLUS RMS-11 


The P/OS operating system does not support magtape devices or remote 
RMS-11 operations. 


P/OS files have decimal version numbers (NBSVER mask in FNB 


NAM) . 


D.3 RSTS/E RMS-11 VERSUS RSX-11M/M-PLUS RMS-11 


This 


section contrasts’ the behaviors of RSTS/E RMS-11 


RSX-11M/M-PLUS RMS-1ll. 


D.3.1 Different Behaviors 


The 


following features behave differently for RSTS/E 


RSX-11M/M--PLUS users: 


Macro library location 


RMS-11 macro libraries for the systems are located in 
files: 


RSTS/E LB: RMSMAC .MLB 
RSX-11M/M-PLUS LB: [1,1] RMSMAC.MLB 


RTV field in FAB 
The RTV field in the FAB has different uses: 


RSTS/E Cluster size 
RSX-11M/M-PLUS Retrieval pointer count 


Maximum bucket size 


The maximum bucket sizes (given by the BKS field in the FAB 


the BKZ fields in ALL blocks) are different: 


RSTS/E 15 blocks 
RSX-11M/M-PLUS 32 blocks 


Area alignment 


The meanings of area alignment codes (in the ALN field of 


ALL block) are different: 
RSTS/E XBSLBN Cluster alignment 
RSX-11M/M-PLUS XBSCYL Cylinder alignment 


XBSLBN Logical block alignment 
XBSVBN Virtual block alignment 


field 


of 


and 


and 


the 


or 


an 
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D.3.2 


Features Not Supported on RSTS/E 


The following RMS-1l features are not supported on RSTS/E, but are 
Supported on RSX-11M/M-PLUS: 


ENTER operation (SENTER macro) 

NXTVOL operation (SNXTVOL macro) 

REMOVE operation (S$REMOVE macro) 

REWIND operation for magtape device (SREWIND macro) 

SPACE operation (S$SPACE macro) 

WAIT operation (SWAIT macro) 

User-provided interlocking (FBSUPI mask in SHR field of FAB) 
Octal file version numbers (NBSVER mask in FNB field of NAM) 
Asynchronous execution of operations (RBSASY mask in ROP field 
of RAB; SYN and ASYN arguments to RABSB macro; RBSBLL symbol 
for length of asynchronous RAB) 

Directories (DID field in NAM block) 


Area extension (ALL block fields for SEXTEND macro) 


Contiguous file extension (FBSCTG mask in FOP field of FAB for 
SEXTEND macro) 


Hard placement (XBSHRD mask in AOP field of ALL block) 


Return of date and protection information by DISPLAY operation 
(PRO block fields and DAT block fields for SDISPLAY macro) 


File expiration date (EDT field in NAM block) and “(file 
revision number (RVN field of NAM block) 


Initial end-of-file context for magtape file (FBSNEF mask in 
FOP field of FAB for SOPEN macro) 


Multivolume magtapes 


SCLOSE macro, 5-3 
SCOMPARE macro, 2-17 
example, 7-3, 7-7, 7-11, 7-15 
SCONNECT macro, 5-6 
SCREATE macro, 5-9 
SDELETE macro, 5-25 
SDISCONNECT macro, 5-27 
SDISPLAY macro, 5-29 
RSTS/E, D-—4 
SENTER macro, 5-35 
RSTS/E, D-4 
SERASE macro, 5-40 
example, 7-11 
SEXTEND macro, 5-46 
RSTS/E, D-4 
SFBCAL macro, C-2 
SFETCH macro, 2-16 
example, 7-3, 7-7, 7-1ll, 7-15 
SFIND macro 
key access, 5-51 
RFA access, 5-54 
sequential access, 5-49 
SFLUSH macro, 5-56 
SFREE macro, 5-58 
SGET macro 
key access, 5-63 
RFA access, 5-67 
sequential access, 5-60 
SGETGSA macro, 2-21 
SGNCAL macro, C-2 
SINIT macro (obsolete), xiv 
SINITIF macro (obsolete), xiv 
SNXTVOL macro, 5-70 
RSTS/E, D-4 
SOFF macro, 2-12 
SOPEN macro, 5-72 
RSTS/E, D-4 
SPARSE macro, 5-86 
example, 7-3, 7-7, 7-ll, 7-15 
SPUT macro 
key access, 5-95 
sequential access, 5-91 
SRBCAL macro, C-3 
SREAD macro 
sequential access, 5-98 
VBN access, 5-100 
SREMOVE macro, 5-102 
RSTS/E, D-4 
SRENAME macro, 5-108 
example, 7-15 
SRETURN macro, 2-20 
SREWIND macro, 5-114 
RSTS/E magtape device, D-4 
SRLCB system routine, 2-22 
SRMSTAT macro, C-3 
SRQCB system routine, 2-22 
SSEARCH macro, 5-116 
example, 7-7, 7-15 
SSET macro, 2-12 
SSETGSA macro, 2-20 
SSPACE macro, 5-120 


INDEX 


RSTS/E, D-4 
SSTORE macro, 2-11 
example, 7-3, 7-7, 7-11, 7-15 
STESTBITS macro, 2-18 
STRUNCATE macro, 5-122 
SUPDATE macro, 5-124 
SWAIT macro, 5-126 
RSTS/E, D-4 
SWRITE macro 
sequential access, 5-127 
VBN access, 5-129 
-EVEN assembler directive 
control block alignment, 2-8 
pool alignment, 2-4 
-MCALL assembler directive, 2-2 
/ML aSsembler switch, 2-22 


Access 
requested 
See FAC field in FAB 
shared 
See SHR field in FAB 
Access mode 
block 
See BKT field in RAB 
record 
See RAC field in RAB 
AID field in ALL block, 2-13 
CLOSE operation, 5-3 
CREATE operation, 5-9, 5-16 
DISPLAY operation, 5-30 
ENTER operation, 5-35 
ERASE operation, 5-40 
EXTEND operation, 5-46 to 5-47 
offset, 6-2 
OPEN operation, 5-73 
PARSE operation, 5-86 
REMOVE operation, 5-102 
RENAME operation, 5-108 
SEARCH operation, 5-116 
summary, 6-3 
Alignment 
See ALN field in ALL block 
ALL block 
chaining to FAB, 2-13 
declaring, 2-8 
initializing, 2-10 
summary, 6-2 
Allocation 
See ALQ field in ALL block 
See ALQ field in FAB 
XAB 
See ALL block 
ALN field in ALL block 
CREATE operation, 5-17 
DISPLAY operation, 5-30 
EXTEND operation, 5-47 
offset, 6-2 
OPEN operation, 5-79 
RSTS/E, D-4 
Summary, 6-4 


Index-1l 


ALQ field in ALL block 
CREATE operation, 5-16, 
DISPLAY operation, 5-30 
EXTEND operation, 5-47 
offset, 6-2 
OPEN operation, 5-79 
RSTS/E, D-4 
summary, 6-5 

ALQ field in FAB 
CREATE operation, 5-16, 5-21 
EXTEND operation, 5-46 to 5-47 
offset, 6-22 
OPEN operation, 
summary, 6-25 

ALQO field in ALL block 
offset, 6-2 

ALQ1 field in ALL block 
offset, 6-2 

ANSI magtape device, 3-2, 5-20, 
5-37, 5-43, 5-77, 5-88, 

5-104, 5-111, 5-118 

AOP field in ALL block 
CREATE operation, 5-17 to 5-18 
DISPLAY operation, 5-30 
EXTEND operation, 5-47 
offset, 6-2 
OPEN operation, 
RSTS/E, D-4 
summary 

XBSCTG mask, 6-6 
XBSHRD mask, 6-7 

Area 

alignment 

See ALN field in ALL block 
allocation 

See ALQ field in ALL block 
bucket size 

See BKZ field in ALL block 
contiguity 

See XBSCTG mask in AOP field 
count 

See NOA field in SUM block 
default extension size 

See DEQ field in ALL block 
description, obtaining 

See DISPLAY operation 
extending allocation 

See EXTEND operation 
identifier 

See AID field in ALL block 
location 

See LOC field in ALL block 
See ALL block 

Assembly, 2-22 

ASYN argument to RABSB macro, 
2-8 
RSTS/E, D-4 

Asynchronous operation 
RAB declaration, 2-8 
See RBSASY mask in ROP field 
waiting for 

See WAIT operation 


5-21 


5-78 


5-79 


BDB pool, 2-8 
BID field in FAB 


INDEX 


offset, 6-22 
summary 
FBSBID code, 6-26 
BID field in RAB 
offset, 6-115 
summary 
RBSBID code, 6-116 
Binary key 
See XBSBN2 mask in DTP field 
See XBSBN4 mask in DTP field 
BKS field in FAB 
CREATE operation, 5-17 
offset, 6-24 
OPEN operation, 5-78 
RSTS/E, D-3 
summary, 6-27 
BKT field in RAB, 4-6, 
4-12 to 4-13 


FIND operation, 5-50, 5-52, 
5-55 

GET operation, 5-61, 5-65, 
5-68 


offset, 6-115 

PUT operation, 5-93, 5-96 

READ operation, 5-98, 5-100 

SPACE operation, 5-120 

summary, 6-117 

WRITE operation, 5-127, 
BKZ field in ALL block 

CREATE operation, 5-17 


5-129 


DISPLAY operation, 5-30 
offset, 6-2 
OPEN operation, 5-79 


RSTS/E, D-3 to D-4 
summary, 6-8 
BLN field in ALL block 
offset, 6-2 
summary 
XBSLAL code, 6-9 
BLN field in DAT block 
offset, 6-14 
summary 
XBSDTL code, 6-15 
BLN field in FAB 
offset, 6-22 
summary 
FBSBLN code, 6-28 
BLN field in KEY block 
offset, 6-67 
summary 
XBSKYL code, 
BLN field in PRO block 
offset, 6-108 
summary 
XBSPRL code, 6-109 
BLN field in RAB 
offset, 6-115 
summary, 6-118 
BLN field in SUM block 
offset, 6-145 
summary 
XBSSML code, 6-146 
Block 
access mode 
See BKT field in RAB 
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locating 
See SPACE operation 
reading 
See READ operation 
size, magtape 
See BLS field in FAB 
writing 
See WRITE operation 
Block context, 4-12 
Block operation, 4-14 
Block operation macro 
SREAD, 5-98, 5-100 
SSPACE, 5-120 
SWRITE, 5-127, 5-129 
declaring, C-3 
Block processing, 4-11 
Block stream, 4-11 
Block-declaration macro, 2-8, 
2-10 
Blocked record 
See FBSBLK mask in RAT field 
BLS field in FAB 
CREATE operation, 5-15 
offset, 6-24 
OPEN operation, 5-79 
summary, 6-29 
BPA field in FAB, 2-7, 3-5 
CLOSE operation, 5-4 
CREATE operation, 5-13 
ENTER operation, 5-36 
ERASE operation, 5-42 
offset, 6-24 
OPEN operation, 5-74 
PARSE operation, 5-87 
REMOVE operation, 5-104 
RENAME operation, 5-110 
SEARCH operation, 5-117 
summary, 6-30 
BPS field in FAB, 2-7, 3-5 
CLOSE operation, 5-4 
CREATE operation, 5-13 
ENTER operation, 5-36 
ERASE operation, 5-42 
offset, 6-24 
OPEN operation, 5-74 
PARSE operation, 5-87 
REMOVE operation, 5-104 
RENAME operation, 5-110 
SEARCH operation, 5-117 
Summary, 6-31 
Bucket 
fill number 
data 
See DFL field in KEY block 
honoring 


See RBSLOA mask in ROP field 


index 
See IFL field in KEY block 

size 

See BKS field in FAB 

See BKZ field in ALL block 

Buffer 

record 

See RBF field in RAB 
user 


INDEX 


See UBF field in RAB 
Buffer pool, 3-5 


Call 
operation routine, 2-14 
arguments in memory, 2-15 
macro argument, 2-14 
Carriage control 
See RAT field in FAB 
Carriage-control device 
See FBSCCL mask in DEV field 
Carriage-return carriage control 
See FBSCR mask in RAT field 
Casette tape device, 3-2, 5-20, 
5-37, 5-43, 5-77, 5-88, 
5-104, 5-111, 5-118 
CDT field in DAT block 
DISPLAY operation, 5-32 
offset, 6-14 
OPEN operation, 5-81 
RSTS/E, D-4 
summary, 6-16 
Central buffer pool, 3-5 
Changed key 
See XBSCHG mask in FLG field 
CLOSE operation, 3-9 
SCLOSE macro, 5-3 
BDB requirement, 2-8 
I/O buffer requirement, 2-7 
wildcard loop, 3-11 
Cluster size 
See RTV field in FAB 
COD field in ALL block 
offset, 6-2 
summary 
XBSALL code, 6-10 
COD field in DAT block 
offset, 6-14 
summary 
XBSDAT code, 6-17 
COD field in KEY block 
offset, 6-67 
summary 
XBSKEY code, 6-70 
COD field in PRO block 
offset, 6-108 
summary 
XBSPRO code, 6-110 
COD field in SUM block 
offset, 6-145 
summary 
XBSSUM code, 6-147 
Code and mask symbol 
declaring 


ALL block, C-3 to C-4 
DAT block, C-3 to C-4 
FAB, C-l 

KEY block, C-3 to C-4 
NAM block, C-2 

PRO block, C-3 to C-4 
RAB, C-2 

SUM block, C-3 to C-4 
XAB, C-4 

value 


ALL block, 6-2 
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DAT block, 6-14 
FAB, 6-22 
KEY block, 6-67 
NAM block, 6-94 
PRO block, 6-108 
RAB, 6-115 
SUM block, 6-145 
Code symbol 
See Code and mask symbol 
Completion 
handler, 2-18 
return macro 
declaring, C-2 
symbol 
declaring, C-3 
Completion status 
See STS field in FAB 
See STS field in RAB 
See STV field in FAB 
See STV field in RAB 
CONNECT operation 
SCONNECT macro, 5-6 
BDB requirement, 2-8 
block stream, 4-13 
I/O buffer requirement, 2-7 
IRAB requirement, 2-5 
key buffer requirement, 2-6 
record stream, 4-8 
Context 
block stream, 4-12 
record stream, 4-3 
Contiguity 
See FBSCTG mask in FOP field 
See XBSCTG mask in AOP field 
Control block, 1-2 
chaining, 2-13 
declaring, 2-8 
examining, 2-16 
field 
See Field 
initializing, 2-8 
setting up, 2-11 
CRE argument to ORGS macro, 2-3 
CREATE operation, 3-8 
SCREATE macro, 5-9 
BDB requirement, 2-8 
declaring with ORGS macro, 2-3 
I/O buffer requirement, 2-7 
IFAB requirement, 2-5 
wildcard loop, 3-1l 
Creation date 
See CDT field in DAT block 
CTX field in FAB, 2-20 
offset, 6-22 
summary, 6-32 
CTX field in RAB, 2-20 
offset, 6-115 
summary, 6-119 
Current-record context, 4-3 


DAN field in KEY block 
CREATE operation, 5-19 
DISPLAY operation, 5-31 
offset, 6-67 
OPEN operation, 5-80 
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Summary, 6-71 
DAT block 
chaining to FAB, 2-13 to 2-14 
declaring, 2-8 
initializing, 2-10 
summary, 6-14 
Data area number 
See DAN field in KEY block 
Date 
See DAT block 
XAB 
See DAT block 
DBS field in KEY block 
DISPLAY operation, 5-31 
offset, 6-68 
OPEN operation, 5-80 
summary, 6-72 
DECtape device, 3-1, 5-20, 
5-37, 5-42, 5-77, 5-88, 
5-104, 5-111, 5-117 
DECTAPE II device, 3-1, 5-20, 
5-37, 5-42, 5-77, 5-88, 
5-104, 5-1l1ll, 5-117 
DEFSSZ argument, C-1l 
Default extension size 
See DEQ field in ALL block 
See DEQ field in FAB 
Default string 
See DNA field in FAB 
Deferred writing 
See FBSDFW mask in FOP field 
DEL argument to ORGS macro, 2-3 
DELETE operation, 4-11 
SDELETE macro, 5-25 
declaring with ORGS macro, 2-3 
Deletion, file marked for 
See FBSMKD mask in FOP field 
DEQ field in ALL block 
CREATE operation, 5-17 
DISPLAY operation, 5-30 
offset, 6-2 
OPEN operation, 5-79 
RSTS/E, D-4 
Summary, 6-11 
DEQ field in FAB 
CREATE operation, 5-17 
offset, 6-22 
OPEN operation, 5-74, 5-78 
Summary, 6-33 
DEV field in FAB, 3-1 to 3-2 
CREATE operation, 5-20 
ENTER operation, 5-37 
ERASE operation, 5-42 to 5-43 
offset, 6-24 
OPEN operation, 5-77 
PARSE operation, 5-88 
REMOVE operation, 5-104 
RENAME operation, 5-l1ll 
SEARCH operation, 
5-117 to 5-118 
Summary, 6-34 
Device 
characteristics 
See DEV field in FAB 
identifier 
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See DVI field in NAM block 
DFINSG argument, C-1l 
DFINSL argument, C-l 
DFL field in KEY block 
CREATE operation, 5-20 
DISPLAY operation, 5-31 
offset, 6-67 
OPEN operation, 5-80 
summary, 6-73 
DID field in NAM block 
CREATE operation, 5-10, 5-21 
ENTER operation, 5-36 to 5-37 
ERASE operation, 5-41 to 5-42 
offset, 6-94 
OPEN operation, 5-73, 5-77 
PARSE operation, 5-87 
REMOVE operation, 5-103, 5-105 
RENAME operation, 
5-109 to 5-111 
SEARCH operation, 5-116, 5-118 
Summary, 6-95 
DID field in NAM block field 
RSTS/E, D-4 
Directory 
wildcard context 
See WDI field in NAM block 
wildcard operation 
See NBSWCH mask in FNB field 
Directory entry 
creating 
See ENTER operation 
deleting 
See REMOVE operation 
replacing 
See RENAME operation 
Directory operation, 3-5 
Directory operation macro 
SENTER, 5-35 
SPARSE, 5-86 
SREMOVE, 5-102 
SRENAME, 5-108 
SSEARCH, 5-116 
declaring, C-2 
Directory processing, 3-l 
DISCONNECT operation 
SDISCONNECT macro, 5-27 
block stream, 4-14 
record stream, 4-9 
Disk device, 3-l, 5-20, 5-37, 
5-42, 5-77, 5-88, 5-104, 
5-111, 5-117 
DISPLAY operation, 3-8 
SDISPLAY macro, 5-29 
BDB requirement, 2-8 
I/O buffer requirement, 2-7 
wildcard loop, 3-11 
DNA field in FAB, 3-3 
CREATE operation, 5-10 
ENTER operation, 5-36 
ERASE operation, 5-41 
offset, 6-24 
OPEN operation, 5-73 
PARSE operation, 5-87 
REMOVE operation, 5-103 
RENAME operation, 
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5-109 to 5-110 
summary, 6-35 
DNS field in FAB, 3-3 
CREATE operation, 5-10 
ENTER operation, 5-36 
ERASE operation, 5-41 
offset, 6-24 
OPEN operation, 5-73 
PARSE operation, 5-87 
REMOVE operation, 5-103 
RENAME operation, 
5-109 to 5-110 
summary, 6-36 
DTP field in KEY block 
CREATE operation, 5-18 
DISPLAY operation, 5-31 
offset, 6-67 
OPEN operation, 5-80 
Summary, 6-74 
Duplicate key 
See XBSDUP mask in FLG field 
DVB field in KEY block 
DISPLAY operation, 5-31 
offset, 6-68 
OPEN operation, 5-80 
summary, 6-75 
DVI field in NAM block, 3-3 
CREATE operation, 5-10, 5-21 
ENTER operation, 5-36 to 5-37 
ERASE operation, 5-41 to 5-42 
offset, 6-94 
OPEN operation, 5-73, 5-77 
PARSE operation, 5-88 
REMOVE operation, 5-103, 5-105 
RENAME operation, 
5-109 to 5-111 
SEARCH operation, 5-116 
Summary, 6-96 


EDT field in DAT block 
DISPLAY operation, 5-32 
offset, 6-14 
OPEN operation, 5-81 
summary, 6-18 

EDT field in NAM block 
RSX-ll, D-4 

ENTER operation, 3-6 
SENTER macro, 5-35 
BDB requirement, 2-8 
I/O buffer requirement, 2-7 
IFAB requirement, 2-5 
wildcard loop, 3-11 

ERS-family symbol 
declaring, C-3 
value, A-1 to A-19 

ERASE operation, 3-8 
SERASE macro, 5-40 
BDB requirement, 2-8 
I/O buffer requirement, 2-7 
IFAB requirement, 2-5 
wildcard loop, 3-10 to 3-11 

nonselective, 3-11 
selective, 3-12 

Error 

assembly-time, 2-22 


Index-5 


fatal, 2-16 
handler, 2-18 

ESA field in NAM block, 
3-10 
CREATE operation, 
ENTER operation, 
ERASE operation, 
offset, 6-94 
OPEN operation, 
PARSE operation, 
REMOVE operation, 
RENAME operation, 
SEARCH operation, 
summary, 6-97 

ESL field in NAM block 
CREATE operation, 5-21 
ENTER operation, 5-37 
ERASE operation, 5-42 
offset, 6-94 
OPEN operation, 
PARSE operation, 
REMOVE operation, 
RENAME operation, 
SEARCH operation, 
summary, 6-98 

ESS field in NAM block 
CREATE operation, 5-10 
ENTER operation, 5-36 
ERASE operation, 5-42 
offset, 6-94 
OPEN operation, 
PARSE operation, 
REMOVE operation, 
RENAME operation, 
Summary, 6-99 

Expanded string 
See ESA field in NAM block 

EXTEND operation, 3-9 
SEXTEND macro, 5-46 
BDB requirement, 2-8 


3-3, 


5-10 
5-36 
5-42 


5-74 

5-87 
5-104 
5-110 
5-116 


5-77 

5-88 
5-105 
5-111 
5-116 


5-74 

5-87 
5-104 
5-110 


I/O buffer requirement, 2-7 
wildcard loop, 3-11 
Extended attribute block 
See XAB 
FS-family macro, 2-10 
declaring, C-l 
example, 7-3, 7-7, 7-1l, 7-15 
FAB 
chaining to RAB, 2-14 
declaring, 2-8 
initializing, 2-10 
summary, 6-22 
FAB field in RAB, 4-2 
chaining FAB to RAB, 2-14 
CONNECT operation, 5-6 
offset, 6-115 
summary, 6-120 
FABSB macro, 2-8, C-l 
example, 7-3, 7-7, 7-11, 7-15 
FABSBT macro, C-l 
FABSE macro, 2-10 
declaring, C-1l 
example, 7-3, 7-7, 7-11, 7-15 


FABOFS macro, C-1l 
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FAC field in FAB 
CREATE operation, 
offset, 6-22 
OPEN operation, 
summary, 6-37 


5-14 


5-75 


Facilities-declaration macro, 


2-2 
declaring, C-2 
Fast deletion 


See RBSFDL mask in ROP field 


Fatal error, 2-16 

FBS—-family symbol 
declaring, C-1l 

FBSBID code in BID field 
summary, 6-26 
value, 6-22 

FBSBLK mask in RAT field 


CREATE operation, 5-11 
OPEN operation, 5-78 
summary, 6-60 
value, 6-23 

FBSBLN code in BLN field 
summary, 6-28 
value, 6-22 

FBSCCL mask in DEV field, 
CREATE operation, 5-20 
ENTER operation, 5-37 
ERASE operation, 5-42 
OPEN operation, 5-77 
PARSE operation, 5-88 
REMOVE operation, 5-104 
RENAME operation, 5-111 
SEARCH operation, 5-117 


value, 6-24 

FBSCR mask in RAT field 
CREATE operation, 5-12 
OPEN operation, 5-78 
value, 6-23 

FBSCTG mask in FOP field 
CREATE operation, 5-18 
EXTEND operation, 5-46 
OPEN operation, 5-78 
RSTS/E, D-4 
summary, 6-40 
value, 6-23 

FBSDEL mask in FAC field 
CREATE operation, 5-14 
OPEN operation, 5-75 
value, 6-22 

FBSDFW mask in FOP field 
CREATE operation, 5-15 
OPEN operation, 5-76 
Summary, 6-41 
value, 6-23 

FBSDLK mask in FOP field 
CREATE operation, 5-15 
OPEN operation, 5-76 
Summary, 6-42 
value, 6-23 

FBSFID mask in FOP field, 
3-10 to 3-12 
CREATE operation, 
ENTER operation, 
ERASE operation, 
OPEN operation, 


5-10 
5-36 
5-41 
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3-1 


3-8, 


5-73 to 5-74 


REMOVE operation, 5-103 


RENAME operation, 
5-109 to 5-110 

summary, 6-43 
value, 6-23 

FBSFIX code in RFM field 
CREATE operation, 5-11 
OPEN operation, 5-78 
value, 6-23 

FBSFTN mask in RAT field 
CREATE operation, 5-12 
OPEN operation, 5-78 
value, 6-23 

FBSGET mask in FAC field 
CREATE operation, 5-14 
OPEN operation, 5-75 
value, 6-22 

FBSGET mask in SHR field 
CREATE operation, 5-14 
OPEN operation, 5-75 
value, 6-22 

FBSIDX code in ORG field 
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3-1 to 3-2 
CREATE operation, 5-20 
ENTER operation, 5-37 


ERASE operation, 5-42 to 5-43 


OPEN operation, 5-77 
PARSE operation, 5-88 


REMOVE operation, 5-104 
RENAME operation, 5-111 


SEARCH operation, 
5-117 to 5-118 

value, 6-24 

FBSREL code in ORG field 
CREATE operation, 5-11 
OPEN operation, 5-78 
value, 6-23 

FBSRWC mask in FOP field 
CLOSE operation, 5-4 
CREATE operation, 5-15 
OPEN operation, 5-77 


SEARCH operation, 5-117 


Summary, 6-47 


value, 6-23 

FBSRWO mask in FOP field 
CREATE operation, 5-15 
OPEN operation, 5-76 
SEARCH operation, 5-117 
summary, 6-48 
value, 6-23 

FBSSDI mask in DEV field, 3-2 
CREATE operation, 5-20 
ENTER operation, 5-37 
ERASE operation, 5-43 
OPEN operation, 5-77 
PARSE operation, 5-88 
REMOVE operation, 5-104 
RENAME operation, 5-111 
SEARCH operation, 5-118 
value, 6-24 

FBSSEQ code in ORG field 
CREATE operation, 5-11 
OPEN operation, 5-78 
value, 6-23 

FBSSQD mask in DEV field, 3-2 


CREATE operation, 5-11 
OPEN operation, 5-78 
value, 6-23 

FBSMDI mask in DEV field, 3-1 
CREATE operation, 5-20 
ENTER operation, 5-37 
ERASE operation, 5-42 
OPEN operation, 5-77 
PARSE operation, 5-88 
REMOVE operation, 5-104 
RENAME operation, 5-111 
SEARCH operation, 5-117 
value, 6-24 

FBSMKD mask in FOP field 
CREATE operation, 5-11 
summary, 6-44 
value, 6-23 

FBSNEF mask in FOP field 
OPEN operation, 5-76 
RSTS/E, D-4 
summary, 6-45 


value, 6-23 

FBSNIL mask in SHR field 
CREATE operation, 5-14 
OPEN operation, 5-75 
value, 6-22 

FBSPOS mask in FOP field 
CREATE operation, 5-15 
summary, 6-46 
value, 6-23 

FBSPRN mask in RAT field 
CREATE operation, 5-12 
OPEN operation, 5-78 
value, 6-23 

FBSPUT mask in FAC field 
CREATE operation, 5-14 
OPEN operation, 5-75 
value, 6-22 

FBSREA mask in FAC field 
CREATE operation, 5-14 
OPEN operation, 5-75 
value, 6-22 

FBSREC mask in DEV field, 


CREATE operation, 5-20 
ENTER operation, 5-37 
ERASE operation, 5-43 
OPEN operation, 5-77 

PARSE operation, 5-88 
REMOVE operation, 


value, 6-24 

FBSSTM code in RFM field 
CREATE operation, 5-11 
OPEN operation, 5-78 
value, 6-23 

FBSSUP mask in FOP field 
CREATE operation, 5-10 
summary, 6-49 
value, 6-23 

FBSTMD mask in FOP field 
CREATE operation, 5-11 
value, 6-23 

FBSTMP mask in FOP field 
CREATE operation, 5-11 
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5-104 
RENAME operation, 5-111 
SEARCH operation, 5-118 


summary, 6-50 
value, 6~23 

FBSTRM mask in DEV field, 3-l 
CREATE operation, 5-20 
ENTER operation, 5-37 
ERASE operation, 5-42 
OPEN operation, 5-77 
PARSE operation, 5-88 
REMOVE operation, 5-104 
RENAME operation, 5-111 
SEARCH operation, 5-117 
value, 6-24 

FBSTRN mask in FAC field 
CREATE operation, 5-14 
OPEN operation, 5-75 
value, 6-22 

FBSUDF code in REM field 
CREATE operation, 5-11 
OPEN operation, 5-78 
value, 6-23 

FBSUPD mask in FAC field 
CREATE operation, 5-14 
OPEN operation, 5-75 
value, 6-22 

FBSUPI mask in SHR field 
CREATE operation, 5-14 
OPEN operation, 5-75 
value, 6-22 


FBSUPI mask in SHR field of FAB 


RSX-1ll, D-4 

FBSVAR code in RFM field 
CREATE operation, 5-11 
OPEN operation, 5-78 
value, 6-23 

FBSVFC code in REM field 
CREATE operation, 5-11 
OPEN operation, 5-78 
value, 6-23 

FBSWRI mask in SHR field 
CREATE operation, 5-14 
OPEN operation, 5-75 
value, 6-22 

FBSWRT mask in FAC field 
CREATE operation, 5-14 
OPEN operation, 5-75 
value, 6-22 

FID field in NAM block 
CREATE operation, 5-21 
ENTER operation, 5-36 
ERASE operation, 
offset, 6-94 
OPEN operation, 5-73, 5-77 
REMOVE operation, 5-105 
RENAME operation, 5-111 
SEARCH operation, 5-118 
summary, 6-100 

Field, 1-2 
clearing bits in, 
comparing value, 
copying value from, 
copying value into, 
examining, 2-16 
initializing, 2-8 
mnemonic, 1-2 
setting bits in, 


2-12 
2-17 
2-16 
2-11 


2-12 


5-41 to 5-42 
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setting up, 2-11 
testing bits in, 
Field-access macro 
SCOMPARE, 2-17 
SFETCH, 2-16 
SOFF, 2-12 
SSET, 2-12 
SSTORE, 2-11 
STESTBITS, 2-18 
declaring, C-2 


2-18 


Field-initialization macro, 


declaring 
ALL block, C-3 
DAT block, C-3 
FAB, C-l 
KEY block, C-3 
NAM block, C-2 
PRO block, C-3 
RAB, C-2 
SUM block, C-3 
Field-offset symbol 
declaring 
ALL block, 
DAT: block, 
FAB, C-l 
KEY block, C-3 
NAM block, C-2 
PRO block, C-3 
RAB, C-2 
SUM block, C-3 to C-4 
XAB, C-4 
value 
ALL block, 6-2 
DAT’ block, 
FAB, 6-22 
KEY block, 
NAM block, 
PRO block, 
RAB, 6-115 
SUM block, 
File 
access requested 
See FAC field in FAB 
access shared 
See SHR field in FAB 
alignment 


to 
to 


Cc 

Cc 
to C-4 

Cc 


to 


6-67 
6-94 
6-108 


6-145 


2-10 


See ALN field in ALL block 


allocation 


See ALQ field in ALL block 


See ALQ field in FAB 
area 

See ALL block 
bucket size 


See BKS field in FAB 


See BKZ field in ALL block 


closing 

See CLOSE operation 
cluster size 

See RTV field in FAB 
contiguity 


See FBSCTG mask in FOP field 
See XBSCTG mask in AOP field 


creating 
See CREATE operation 
creation date 
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See CDT field in DAT block File processing, 3-1 
date File specification 
See DAT block fully qualified, 3-4 
default extension size merged string, 3-3 
See DEQ field in ALL block parsing 
See DEQ field in FAB See PARSE operation 
deleting wildcard, 3-9 
See ERASE operation Fill number 
extending allocation data bucket 
See EXTEND operation See DFL field in KEY block 
identifier index bucket 
See FID field in NAM block See IFL field in KEY block 
internal file identifier FIN argument to ORGS macro, 2-3 
See IFI field in FAB FIND operation, 4-10 
location SFIND macro 
See LOC field in ALL block key access, 5-51 
locking RFA access, 5-54 
See FBSDLK mask in FOP field sequential access, 5-49 
name block declaring with ORGS macro, 2-3 
See NAM block ' Fixed-control-size 
opening See FSZ field in FAB 
See OPEN operation Fixed-length record format 
organization See FBSFIX code in RFM field 
See ORG field in FAB FLG field in KEY block 
owner CREATE operation, 5-19 
See PRG field in PRO block DISPLAY operation, 5-31 
protection offset, 6-67 
See PRO field in PRO block OPEN operation, 5-80 
record-output characteristic summary 
See RAT field in FAB XBSCHG mask, 6-76 
renaming XBSDUP mask, 6-77 
See RENAME operation XBSNUL mask, 6-78 
revision date FLUSH operation 
See RDT field in DAT block SFLUSH macro, 5-56 
revision number record stream, 4-8 
See RVN field in DAT block FNA field in FAB, 3-3 
specification string CREATE operation, 5-10 
default ENTER operation, 5-36 
See DNA field in FAB ERASE operation, 5-41 
parsing offset, 6-24 
See FNB field in NAM block OPEN operation, 5-73 
See FNA field in FAB PARSE operation, 5-87 
string REMOVE operation, 5-103 
See FNA field in FAB RENAME operation, 
Ssupersession 5-109 to 5-110 
See FBSSUP mask in FOP field summary, 6-38 
truncating FNB field in NAM block, 3-3, 
See TRUNCATE operation 3-10 to 3-11 
wildcard context CREATE operation, 5-21 
See WCC field in NAM block ENTER operation, 5-37 to 5-38 
wildcard operation ERASE operation, 5-41, 5-43 
See NBSWCH mask in FNB field offset, 6-94 
wildcard search OPEN operation, 5-81 
See SEARCH operation PARSE operation, 5-88 
File access block REMOVE operation, 5-103, 5-105 
See FAB RENAME operation, 5-109, 
File operation, 3-7 5-111 to 5-112 
File operation macro SEARCH operation, 5-116, 5-118 
SCLOSE, 5-3 summary, 6-101 
SCREATE, 5-9 NBSWCH mask, 6-102 
SDISPLAY, 5-29 wildcard loop, 3-11 
SERASE, 5-40 FNS field in FAB, 3-3 
SEXTEND, 5-46 CREATE operation, 5-10 
SOPEN, 5-72 ENTER operation, 5-36 
declaring, C-2 ERASE operation, 5-41 
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offset, 6-24 

OPEN operation, 5-73 
PARSE operation, 5-87 
REMOVE operation, 5-103 
RENAME operation, 

5-109 to 5-110 

summary, 6-39 

FOP field in FAB, 3-8, 
3-10 to 3-12 
CLOSE operation, 5-4 
CREATE operation, 

5-10 to 5-11, 5-15, 5-18 
ENTER operation, 5-36 
ERASE operation, 5-41 
EXTEND operation, 5-46 
offset, 6-23 
OPEN operation, 5-73 to 5-74, 

5-76 to 5-78 
REMOVE operation, 5-103 
RENAME operation, 

5-109 to 5-110 
SEARCH operation, 5-117 
summary 

FBSCTG mask, 6-40 

FBSDFW mask, 6-41 

FBSDLK mask, 6-42 

FBSFID mask, 6-43 

FBSMKD mask, 6-44 

FBSNEF mask, 6-45 

FBSPOS mask, 6-46 

FBSRWC mask, 6-47 

FBSRWO mask, 6-48 

FBSSUP mask, 6-49 

FBSTMP mask, 6-50 

FORTRAN-style carriage control 

See FBSFTN mask in RAT field 
FREE operation 

SFREE macro, 5-58 

block stream, 4-13 

record stream, 4-9 
Free-space list for pool, 2-21 
FSZ field in FAB 

CREATE operation, 5-11 

offset, 6-24 

OPEN operation, 5-78 

summary, 6-51 


GET argument to ORGS macro, 2-3 
GET operation, 4-10 
SGET macro 
key access, 5-63 
RFA access, 5-67 
sequential access, 5-60 


declaring with ORGS macro, 2-3 


Get-space routine, 2-20 
example, 7-18 
macro 
declaring, C-2 
RMS-ll-supplied, 2-4 
GSAS macro, 2-20 
example, 7-3, 7-7, 7-1l, 7-15 


Hard location 
See XBSHRD mask in AOP field 
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I/O buffer pool, 2-6 
IAN field in KEY block 
CREATE operation, 5-19 
DISPLAY operation, 5-31 
offset, 6-67 
OPEN operation, 5-80 
summary, 6-79 
IBS field in KEY block 
DISPLAY operation, 5-31 
offset, 6-68 
OPEN, operation, 5-80 
summary, 6-80 
IDB pool, 2-5 
IDX argument to ORGS macro, 2-3 
IFAB pool, 2-5 
IFI field in FAB 
CLOSE operation, 5-3 to 5-4 
CONNECT operation, 5-6 
CREATE operation, 5-20 
DISPLAY operation, 5-30 
EXTEND operation, 5-46 
offset, 6-22 
OPEN operation, 5-77 
summary, 6-52 
IFL field in KEY block 
CREATE operation, 5~20 
DISPLAY operation, 5-31 
offset, 6-67 
OPEN operation, 5-80 
summary, 6-81 
Index 
area bucket size 
See IBS field in KEY block 
area number 
higher levels 
See IAN field in KEY block 
lowest level 
See LAN field in KEY block 
count 
See NOK field in SUM block 
data bucket size 
See DBS field in KEY block 
data bucket VBN 
See DVB field in KEY block 
description, obtaining 
See DISPLAY operation 
level count 
See LVL field in KEY block 
reference number 
See REF field in KEY block 
root bucket VBN 
See RVB field in KEY block 
See KEY block 
Indexed file 
declaring with ORGS macro, 2-3 
Indexed file organization 
See FBSIDX code 
Initialization 
field, 2-10 
Integer key 
See XBSIN2 mask in DTP field 
See XBSIN4 mask in DTP field 
Internal file identifier 
See IFI field in FAB 
Internal stream identifier 
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See ISI field in RAB declaring, 2-8 
IRAB pool, 2-5 initializing, 2-10 
ISI field in RAB, 4-2 summary, 6-67 
CONNECT operation, 5-7 Key buffer pool, 2-6 
DELETE operation, 5-25 Key record access 
DISCONNECT operation, 5-27 See RBSKEY code in RAC field 
FIND operation, 5-49, 5-51, KNM field in KEY block 
5-54 CREATE operation, 5-18 
FLUSH operation, 5-56 DISPLAY operation, 5-30 
FREE operation, 5-58 offset, 6-68 
GET operation, 5-60, 5-63, OPEN operation, 5-74 
5-67 Summary, 6-82 
NXTVOL operation, 5-70 KRF field in RAB, 4-5 
offset, 6-115 CONNECT operation, 5-7 
PUT operation, 5-91, 5-95 FIND operation, 5-51 
READ operation, 5-98, 5-100 GET operation, 5-63 
REWIND operation, 5-114 offset, 6-115 
SPACE operation, 5-120 REWIND operation, 5-114 
summary, 6-121 summary, 6-123 
TRUNCATE operation, 5-122 KSZ field in RAB, 4-5 to 4-6 
UPDATE operation, 5-124 FIND operation, 5-52 
WAIT operation, 5-126 GET operation, 5-63 
WRITE operation, 5-127, 5-129 offset, 6-115 
PUT operation, 5-96 
KBF field in RAB, 4-5 summary, 6-124 
FIND operation, 5-52 
GET operation, 5-63 LAN field in KEY block 
offset, 6-115 CREATE operation, 5-19 
PUT operation, 5-96 DISPLAY operation, 5-31 
summary, 6-122 offset, 6-67 
Key OPEN operation, 5-80 
buffer address Summary, 6-83 
See KBF field in RAB _LCH field in FAB, 3-2 
buffer size CREATE operation, 5-13 
See KSZ field in RAB ENTER operation, 5-36 
changes ERASE operation, 5-42 
See XBSCHG mask in FLG field offset, 6-24 
characteristics OPEN operation, 5-74 
See FLG field in KEY block PARSE operation, 5-87 
data type REMOVE operation, 5-104 
See DTP field in KEY block RENAME operation, 5-110 
duplication SEARCH operation, 5-117 
See XBSDUP mask in FLG field summary, 6-53 
match criterion LOC field in ALL block 
See RBSKGE mask in ROP field CREATE operation, 5-17 
See RBSKGT mask in ROP field EXTEND operation, 5-47 
name offset, 6-2 
See KNM field in KEY block RSTS/E, D-4 
null character Summary, 6-12 
See NUL field in KEY block LOCO field in ALL block 
reference offset, 6-2 
See KRF field in RAB LOC] field in ALL block 
segment offset, 6-2 
position Locate mode 
See POS field in KEY block See RBSLOC mask in ROP field 
size Location 
See SIZ field in KEY block hard 
segment count See XBSHRD mask in AOP field 
See NSG field in KEY block See LOC field in ALL block 
size, total Locking, file 
See TKS field in KEY block See FBSDLK mask in FOP field 
XAB Logical channel number 
See KEY block See LCH field in FAB 
KEY block LRL field in FAB 
chaining to FAB, 2-13 to 2-14 CREATE operation, 5-20 
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offset, 6-24 
OPEN operation, 5-79 
Summary, 6-54 

LVL field in KEY block 
DISPLAY operation, 5-32 
offset, 6-67 
OPEN operation, 5-80 
summary, 6-84 


Macro library 
RMSMAC .MLB, 2-22 
RSTS/E, D-3 
Macro-declaration macro, 2-2 
Magtape 
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See FBSNEF mask in FOP field 
See FBSPOS mask in FOP field 
See RBSEOF mask in ROP field 
rewind-after-closing 
See FBSRWC mask in FOP field 
rewind-before-creating 
See FBSRWO mask in FOP field 
rewind-before-opening 
See FBSRWO mask in FOP field 
Magtape block size 
See BLS field in FAB 
Magtape device, 3-2, 5-20, 
5-37, 5-43, 5-77, 5-88, 
5-104, 5-111, 5-118 
ANSI, 3-2, 5-20, 5-37, 5-43, 
5-77, 5-88, 5-104, 5-111, 
5-118 
P/OS, D-3 
Mark-for-deletion 
See FBSMKD mask in FOP field 
Mask symbol 
See Code and mask symbol 
Mass insertion 
See RBSMAS mask in ROP field 
Match criterion 
See RBSKGE mask in ROP field 
See RBSKGT mask in ROP field 
MBC field in RAB 
CONNECT operation, 5-6 
offset, 6-115 
summary, 6-125 
MBF field in RAB 
CONNECT operation, 5-6 
offset, 6-115 
summary, 6-126 
Merged string, 3-3 
MRL field in KEY block 
DISPLAY operation, 5-32 
offset, 6-68 
OPEN operation, 5-80 
Summary, 6-85 
MRN field in FAB 
CREATE operation, 5-13 
offset, 6-24 
OPEN operation, 5-79 
summary, 6-55 
MRS field in FAB 
CREATE operation, 5-12 
offset, 6-24 
OPEN operation, 5-79 
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See MBC field in RAB 
Multibuffer count 

See MBF field in RAB 
Multidirectory device 

See FBSMDI mask in DEV field 


NS-family macro, 2-10 
declaring, C-2 
example, 7-3, 7-7, 7-1l, 7-15 
NAM block 
chaining to FAB, 2-13 
declaring, 2-8 
identification by 
See FBSFID mask in FOP field 
initializing, 2-10 
summary, 6-94 
NAM field in FAB 
chaining NAM block to FAB, 
2-13 
CREATE operation, 5-9 
ENTER operation, 5-35 
ERASE operation, 5-40 
offset, 6-24 
OPEN operation, 5-72 
PARSE operation, 5-86 
REMOVE operation, 5-102 
RENAME operation, 5-108 
SEARCH operation, 5-116 
summary, 6-57 
NAMSB macro, 2-8, C-2 
example, 7-3, 7-7, 7-1l, 7-15 
NAMSE macro, 2-10 
declaring, C-2 
example, 7-3, 7-7, 7-11, 7-15 
NAMOFS macro, C-2 
NBS-family symbol 
declaring, C-2 
NBSDEV mask in FNB field 
CREATE operation, 5-21 
ENTER operation, 5-37 
ERASE operation, 5-43 
OPEN operation, 5-81 
PARSE operation, 5-88 
REMOVE operation, 5-105 
RENAME operation, 5-11l 
value, 6-94 
NBSDIR mask in FNB field 
CREATE operation, 5-21 
ENTER operation, 5-37 
ERASE operation, 5-43 
OPEN operation, 5-81 
PARSE operation, 5-88 
REMOVE operation, 5-105 
RENAME operation, 5-111 
value, 6-94 
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CREATE operation, 5-21 
ENTER operation, 5-37 
ERASE operation, 5-43 
OPEN operation, 5-81 
PARSE operation 
(set if NBSQUO is set), 5-88 
REMOVE operation, 5-105 
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ENTER operation, 5-37 
ERASE operation, 5-43 
OPEN operation, 5-81 
PARSE operation, 5-88 
REMOVE operation, 5-105 
RENAME operation, 5-111 
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CREATE operation, 5-21 
ENTER operation, 5-37 
ERASE operation, 5-43 
OPEN operation, 5-81 
PARSE operation, 5-88 
REMOVE operation, 5-105 
RENAME operation, 5-111 
value, 6-94 
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CREATE operation, 5-21 
ENTER operation, 5-37 
ERASE operation, 5-43 
OPEN operation, 5-81 
PARSE operation 
(set if NBSQUO is set), 5-88 
REMOVE operation, 5-105 
RENAME operation, 5-111 
value, 6-94 
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CREATE operation, 5-21 
ENTER operation, 5-37 
ERASE operation, 5-43 
OPEN operation, 5-81 
PARSE operation, 5-88 
REMOVE operation, 5-105 
RENAME operation, 5-111 
value, 6-94 
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RSX-11, D-3 to D-4 


NBSWCH mask in FNB field, 


3-10 to 3-11 

CREATE operation, 5-21 

ENTER operation, 5-38 

ERASE operation, 5-41, 5-43 
OPEN operation, 5-81 

PARSE operation, 5-88 

REMOVE operation, 5-103, 5-105 
RENAME operation, 5-109, 5-112 
SEARCH operation, 5-116, 5-118 
summary, 6-102 

value, 6-94 

wildcard loop, 3-11 
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CREATE operation, 5-21 
ENTER operation, 5-37 
ERASE operation, 5-43 
OPEN operation, 5-81 
PARSE operation, 5-88 
REMOVE operation, 5-105 
RENAME operation, 5-111 
value, 6-94 
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ENTER operation, 5-37 
ERASE operation, 5-43 
OPEN operation, 5-81 
PARSE operation, 5-88 
REMOVE operation, 5-105 
RENAME operation, 5-111 
value, 6-94 

NBSWTY mask in FNB field 
CREATE operation, 5-21 
ENTER operation, 5-37 
ERASE operation, 5-43 
OPEN operation, 5-81 
PARSE operation, 5-88 
REMOVE operation, 5-105 
RENAME operation, 5-111 
value, 6-94 

NBSWVE mask in FNB field 
CREATE operation, 5-21 
ENTER operation, 5-37 
ERASE operation, 5-43 
OPEN operation, 5-81 
PARSE operation, 5-88 
REMOVE operation, 5-105 
RENAME operation, 5-111 
value, 6-94 

Next-record context, 4-3 

NOA field in SUM block 
DISPLAY operation, 5-32 
offset, 6-145 
OPEN operation, 5-81 
summary, 6-148 

NOK field in SUM block 
DISPLAY operation, 5-32 
offset, 6-145 
OPEN operation, 5-81 
summary, 6-149 

NSG field in KEY block 
DISPLAY operation, 5-31 
offset, 6-68 
OPEN operation, 5-81 
summary, 6-86 

NUL field in KEY block 
CREATE operation, 5-19 
DISPLAY operation, 5-31 
offset, 6-67 
OPEN operation, 5-80 
summary, 6-87 

Null key character 
See NUL field in KEY block 
See XBSNUL mask in FLG field 

NXT field in ALL block 
CLOSE operation, 5-3 
CREATE operation, 5-9 
DISPLAY operation, 5-30 
ENTER operation, 5-35 
ERASE operation, 5-40 
EXTEND operation, 5-46 
offset, 6-2 
OPEN operation, 5-73 
PARSE operation, 5-86 
REMOVE operation, 5-102 
RENAME operation, 5-108 
SEARCH operation, 5-116 
summary, 6-13 

NXT field in DAT block 
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CLOSE operation, 5-3 FAB field offset, C-l 
CREATE operation, 5-9 KEY block, C-3 to C-4 
DISPLAY operation, 5-30 NAM block field offset, C-2 
ENTER operation, 5-35 PRO block, C-3 to C-4 
ERASE operation, 5-40 RAB, C-2 
EXTEND operation, 5-46 SUM block, C-3 to C-4 
offset, 6-14 XAB, C-4 
OPEN operation, 5-73 value 
PARSE operation, 5-86 ALL block, 6-2 
REMOVE operation, 5-102 DAT block, 6-14 
RENAME operation, 5-108 FAB, 6-22 to 6-24 
SEARCH operation, 5-116 KEY block, 6-67 to 6-68 
summary, 6-19 NAM block, 6-94 
NXT field in KEY block PRO block, 6-108 
CLOSE operation, 5-3 RAB, 6-115 
CREATE operation, 5-9 SUM block, 6-145 
DISPLAY operation, 5-30 OPEN operation, 3-8 
ENTER operation, 5-35 SOPEN macro, 5-72 
ERASE operation, 5-40 BDB requirement, 2-8 
EXTEND operation, 5-46 I/O buffer requirement, 2-7 
offset, 6-67 IFAB requirement, 2-5 
OPEN operation, 5-73 wildcard loop, 3-11 to 3-12 
PARSE operation, 5-86 Operation, 1-2 
REMOVE operation, 5-102 routine 
RENAME operation, 5-108 calling, 2-14 
SEARCH operation, 5-116 return, 2-15 
Summary, 6-88 using, 2-10 
NXT field in PRO block Operation macro, 1-2, 2-10 
CLOSE operation, 5-3 ORG field in FAB 
CREATE operation, 5-9 CREATE operation, 5-11 
DISPLAY operation, 5-30 offset, 6-23 
ENTER operation, 5-35 OPEN operation, 5-78 
ERASE operation, 5-40 summary, 6-58 
EXTEND operation, 5-46 ORGS macro, 2-2 
offset, 6-108 Organization, file 
OPEN operation, 5-73 See ORG field in FAB 
PARSE operation, 5-86 Owner, file 
REMOVE operation, 5-102 See PRG field in PRO block 
RENAME operation, 5-108 
SEARCH operation, 5-116 PS-family macro 
Summary, 6-111 declaring, C-2 
NXT field in SUM block PSBDB macro 
CLOSE operation, 5-3 argument computation, 2-8 
CREATE operation, 5-9 format, 2-4 
DISPLAY operation, 5-30 PSBUF macro 
ENTER operation, 5-35 argument computation, 2-7 
ERASE operation, 5-40 format, 2-4 
EXTEND operation, 5-46 PSFAB macro 
offset, 6-145 argument computation, 2-5 
OPEN operation, 5-73 format, 2-4 
PARSE operation, 5-86 PSIDX macro 
REMOVE operation, 5-102 argument computation, 2-5 
RENAME operation, 5-108 format, 2-4 
SEARCH operation, 5-116 PSRAB macro 
summary, 6-150 argument computation, 2-5 
NXT field in XAB format, 2-4 
chaining XABs to FAB, 2-13 PSRABX macro 
NXTVOL operation argument computation, 
SNXTVOL macro, 5-70 2-5 to 2-6 
record stream, 4-9 format, 2-4 
Packed decimal key 
OS-family symbol See XBSPAC mask in DTP field 
declaring PARSE operation, 3-6 
ALL block, C-3 to C-4 SPARSE macro, 5-86 
DAT block, C-3 to C-4 BDB requirement, 2-8 


Index-14 


I/O buffer requirement, 2-7 
IFAB requirement, 2-5 
wildcard initialization, 

Pool 
buffer descriptor block, 
declaring space, 2-4 
free-space list, 2-21 
I/O buffer, 2-6 
index descriptor block, 
internal FAB, 2-5 
internal RAB, 2-5 
key buffer, 2-6 
See also Get-space routine 

POOLSB macro, 2-4, C-2 

POOLSE macro, 2-4 
declaring, C-2 
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Pool-declaration macro, 2-4 
declaring, C-2 

POS field in KEY block 
CREATE operation, 5-18 
DISPLAY operation, 5-31 
offset, 6-68 
OPEN operation, 5-80 
Summary, 6-89 

POSO field in KEY block 
offset, 6-68 

POS1 field in KEY block 
offset, 6-68 

POS2 field in KEY block 
offset, 6-68 

POS3 field in KEY block 
offset, 6-68 

POS4 field in KEY block 
offset, 6-68 

POS5 field in KEY block 
offset, 6-68 

POS6 field in KEY block 
offset, 6-68 

POS7 field in KEY block 
offset, 6-68 

Positioning 
magtape 


See FBSNEF mask in FOP field 
See FBSPOS mask in FOP field 


PRG field in PRO block 
CLOSE operation, 5-3 
DISPLAY operation, 5-32 
offset, 6-108 
OPEN operation, 
RSTS/E, D-4 
summary, 6-112 

Printer device, 3-l, 5-20, 
5-37, 5-42, 5-77, 5-88, 
5-104, 5-111, 5-117 

Private buffer pool 
See BPA field in FAB 
See BPS field in FAB 

PRJI field in PRO block 
CLOSE operation, 5-3 
DISPLAY operation, 5-32 
offset, 6-108 
OPEN operation, 
RSTS/E, D-4 
summary, 6-113 

PRO block 
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chaining to FAB, 2-13 to 2- 
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initializing, 2-10 


summary, 6-108 
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CLOSE operation, 5-3 
CREATE operation, 5-ll 
DISPLAY operation, 5-32 
offset, 6-108 
OPEN operation, 
RSTS/E, D=4 
summary, 6-114 

PRO/RMS-11 


5-81 


contrasted with RSTS/E RMS- 


D-1 


contrasted with RSX-11l RMS- 


D-3 
Prologue version number 
See PVN field in SUM block 
Protection 
file 
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ll, 


ll, 


See PRO field in PRO block 


XAB 
See PRO block 
PUT argument to ORGS macro, 
PUT operation, 4-10 
SPUT macro 
key access, 5-95 
sequential access, 5-91 
declaring with ORGS macro, 
PVN field in SUM block 
DISPLAY operation, 5-32 
offset, 6-145 
OPEN operation, 
Summary, 6-151 
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RS-family macro, 2-10 
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RAB 
declaring, 2-8 
initializing, 
summary, 6-115 
RABSB macro, 2-8, 
RABSBT macro, C-2 
RABSE macro, 2-10 
declaring, C-2 
RABOFS macro, C-2 
RAC field in RAB, 
FIND operation, 
5-54 
GET operation, 
5-67 
offset, 6-115 
PUT operation, 
summary, 6-127 
RAT field in FAB 
CREATE operation, 
offset, 6-23 
OPEN operation, 
summary, 6-59 
FBSBLK mask, 
RBS-family symbol 
declaring, C-2 
RBSASY mask in ROP field, 
CONNECT operation, 5-7 
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DELETE operation, 5-25 


DISCONNECT operation, 5-27 

FIND operation, 5-49, 5-51, 
5-54 

FLUSH operation, 5-56 

FREE operation, 5-58 

GET operation, 5-60, 5-63, 
5-67 

NXTVOL operation, 5-70 

PUT operation, 5-91, 5-95 

READ operation, 5-98, 5-100 

REWIND operation, 5-114 

RSTS/E, D-4 

SPACE operation, 5-120 

summary, 6-131 

TRUNCATE operation, 5-122 

UPDATE operation, 5-124 

value, 6-115 

WRITE operation, 5-127, 5-129 


RBSBID code in BID field 
summary, 6-116 
value, 6-115 

RBSBLL code in BLN field 
RSTS/E, D-4 
value, 6-115 

RBSBLN code in BLN field 
value, 6-115 

RBSEOF mask in ROP field 
CONNECT operation, 5-7 
summary, 6-132 
value, 6-115 

RBSFDL mask in ROP field 


DELETE operation, 5-25 
Summary, 6-133 
value, 6-115 

RBSKEY code in RAC field, 4-5 
FIND operation, 5-51 
GET operation, 5-63 
PUT operation, 5-95 
value, 6-115 

RBSKGE mask in ROP field, 
4-5 to 4-6 
FIND operation, 5-52 
GET operation, 5-64 
Summary, 6-134 
value, 6-115 

RBSKGT mask in ROP field, 
4-5 to 4-6 
FIND operation, 5-52 
GET operation, 5-64 
Summary, 6-135 
value, 6-115 

RBSLOA mask in ROP field 
PUT operation, 5-92, 5-96 
Summary, 6-136 
UPDATE operation, 5-124 
value, 6-115 

RBSLOC mask in ROP field, 4-7 
CONNECT operation, 5-6 
GET operation, 5-61, 5-64, 

5-68 

PUT operation, 5-92 
summary, 6-137 
value, 6-115 
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RBSRFA code in RAC field, 


FI 


GET operation, 
value, 
RBSSEQ code in RAC field, 
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GET operation, 
PUT operation, 
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RBSUIF mask in ROP field, 
PUT operation, 
summary, 
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CONNECT operation, 
GET operation, 


of 


PUT operation, 


READ operation, 
summary, 
UPDATE operation, 
WRITE operation, 


RDT 
DI 
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OPEN operation, 
RSTS/E, 
summary, 
READ operation, 


5-92 

6-138 
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5-54 
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ND operation, 


6-115 

4-4 
5-49 

5-60 
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ND operation, 
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4-4 
5-92, 5-96 
6-139 
lue, 6-115 
field in RAB, 4-7, 4-13 
5-7 
5-61, 5-65, 
5-68 
fset, 6-115 
5-92 to 5-93, 
5-95 
5-99, 5-101 
6-128 

5-124 
5-127 
field in DAT block 
SPLAY operation, 5-32 
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SREAD macro 
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VBN access, 5-100 
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See RAC field in 
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See FBSBLK mask in RAT field 
ffer address 
See RBF field in RAB 
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See RBSFDL mask in ROP field 
See DELETE operation 
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See RBSFDL mask in ROP field 
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See RFM field in FAB 
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See FIND operation 
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replacing 
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See UPDATE operation 
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See RSZ field in RAB 
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See RBSUIF mask in ROP field 


writing 
See PUT operation 
Record access block 
See RAB field in RAB 
Record access mode, 4-4 
Record context, 4-3 
Record file address 
See RFA field in RAB 
Record length 
longest 
See LRL field in FAB 
maximum 
See MRL field in FAB 
Record number 
maximum 
See MRN field in FAB 
Record operation, 4-9 
Record operation macro 
SDELETE, 5-25 
SFIND, 5-49, 5-51, 5-54 
SGET, 5-60, 5-63, 5-67 
SPUT, 5-91, 5-95 
STRUNCATE, 5-122 
SUPDATE, 5-124 
declaring, C-3 
Record processing, 4-3 
Record stream, 4-3 
Record-oriented device 
See FBSREC mask in DEV field 
Record-output characteristic 
See RAT field in FAB 
REF field in KEY block, 2-14 
CLOSE operation, 5-3 
CREATE operation, 5-9, 5-18 
DISPLAY operation, 5-30 
ENTER operation, 5-35 
ERASE operation, 5-40 
EXTEND operation, 5-46 
offset, 6-67 
OPEN operation, 5-73 to 5-74 
PARSE operation, 5-86 
REMOVE operation, 5-102 
RENAME operation, 5-108 
SEARCH operation, 5-116 
summary, 6-90 
REL argument to ORGS macro, 2-3 
Relative file 


declaring with ORGS macro, 2-3 


Relative file organization 
See FBSREL code 
Relative record number 
See BKT field in RAB 
Remote operation 
P/OS, D-3 
REMOVE operation, 3-6 
SREMOVE macro, 5-102 
BDB requirement, 2-8 
I/O buffer requirement, 2-7 
IFAB requirement, 2-5 
wildcard loop, 3-10 to 3-11 
nonselective, 3-11 
selective, 3-12 
RENAME operation, 3-6 
SRENAME macro, 5-108 
BDB requirement, 2-8 
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I/O buffer requirement, 2-7 
IFAB requirement, 2-5 
wildcard loop, 3-10 to 3-11 
nonselective, 3-11 
selective, 3-12 
Resultant string 
See RSA field in NAM block 
Retrieval pointer count 
See RTV field in FAB 
Return 
operation, from, 2-15 
Return from completion handler, 
2-20 
Revision date 
See RDT field in DAT block 
Revision number 
See RVN field in DAT block 
REWIND operation 
SREWIND macro, 5-114 
record stream, 4-9 
RFA field in RAB, 4-6 
CONNECT operation, 5-7 
FIND operation, 5-50, 5-52, 
5-54 
GET operation, 5-61, 5-65, 
5-67 
offset, 6-115 
PUT operation, 5-93, 5-96 
READ operation, 5-99, 5-101 
summary, 6-129 
WRITE operation, 5-128, 5-130 
RFA record access 
See RBSRFA code in RAC field 
RFM field in FAB 
CREATE operation, 5-11 
offset, 6-23 
OPEN operation, 5-78 
summary, 6-61 
RHB field in RAB, 4-7 
GET operation, 5-61, 5-64, 
5-68 
offset, 6-115 
PUT operation, 5-92, 5-96 
summary, 6-130 
UPDATE operation, 5-124 
RMSMAC.MLB macro library, 2-22 
RSTS/E, D-3 
ROP field in RAB, 4-l, 
4-4 to 4-7 
CONNECT operation, 5-6 to 5-7 
DELETE operation, 5-25 
DISCONNECT operation, 5-27 
FIND operation, 5-49, 
5-51 to 5-52, 5-54 
FLUSH operation, 5-56 
FREE operation, 5-58 
GET operation, 5-60 to 5-61, 
5-63 to 5-64, 5-67 to 5-68 
NXTVOL operation, 5-70 
offset, 6-115 
PUT operation, 5-91 to 5-92, 
5-95 to 5-96 
READ operation, 5-98, 5-100 
REWIND operation, 5-114 
SPACE operation, 5-120 
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RBSASY mask, 6-131 
RBSEOF mask, 6-132 
RBSFDL mask, 6-133 
RBSKGE mask, 6-134 
RBSKGT mask, 6-135 
RBSLOA mask, 6-136 
RBSLOC mask, 6-137 
RBSMAS mask, 6-138 
RBSUIF mask, 6-139 
TRUNCATE operation, 5-122 
UPDATE operation, 5-124 
WRITE operation, 5-127, 5-129 
RRN 
See BKT field in RAB 
RSA field in NAM block, 3-10 
offset, 6-94 
SEARCH operation, 5-116 
summary, 6-103 
RSL field in NAM block 
CREATE operation, 5-21 
ENTER operation, 5-38 
ERASE operation, 5-43 
offset, 6-94 
OPEN operation, 5-81 
PARSE operation, 5-87 
REMOVE operation, 5-105 
RENAME operation, 5-112 
SEARCH operation, 
5-116 to 5-117 
summary, 6-104 
RSS field in NAM block 
offset, 6-94 
SEARCH operation, 5-116 
summary, 6-105 
RSTS/E RMS-11 
contrasted with PRO/RMS-1l1l, 
D-1 
contrasted with RSX-1l11l RMS-11l, 
D-3 
RSX-11M/M-PLUS RMS-11l 
contrasted with PRO/RMS-11, 
D-3 
contrasted with RSTS/E RMS-1l1, 
D-3 
RSZ field in RAB, 4-7, 4-13 
GET operation, 5-61, 5-65, 
5-68 
offset, 6-115 
PUT operation, 5-92, 5-95 
READ operation, 5-99, 5-101 
Summary, 6-140 
UPDATE operation, 5-124 
WRITE operation, 5-127, 5-129 
RTV field in FAB 
CREATE operation, 5-13 
offset, 6-23 
OPEN operation, 5-75 
RSTS/E, D-3 
Summary, 6-62 
RVB field in KEY block 
DISPLAY operation, 5-31 
offset, 6-68 
OPEN operation, 5-80 
summary, 6-91 


INDEX 


RVN field in DAT block 
DISPLAY operation, 5-32 
offset, 6-14 
OPEN operation, 5-81 
RSTS/E, D-4 
Summary, 6-21 

RVN field in NAM block 
RSX-11l, D-4 


SEARCH operation 
SSEARCH macro, 5-116 
BDB requirement, 2-8 
I/O buffer requirement, 2-7 
IFAB requirement, 2-5 
wildcard loop, 3-10 
explicit, 3-12 
implicit, 3-10 to 3-1l 
SEQ argument to ORGS macro, 2-3 
Sequential block access 
See BKT field in RAB 
Sequential device 
See FBSSQD mask in DEV field 
Sequential file 
declaring with ORGS macro, 2-3 
Sequential file organization 
See FBSSEQ code 
Sequential record access 
See RBSSEQ code in RAC field 
Shared access 
See SHR field in FAB 
SHR field in FAB 
CREATE operation, 5-14 
offset, 6-22 
OPEN operation, 5-75 
READ operation, 5-99, 5-101 
summary, 6-63 
WRITE operation, 5-127, 5-129 
Single-directory device 
See FBSSDI mask in DEV field 
SIZ field in KEY block 
CREATE operation, 5-18 
DISPLAY operation, 5-31 
offset, 6-68 
OPEN operation, 5-80 
Summary, 6-92 
SIZ0 field in KEY block 
offset, 6-68 
SI1Z1 field in KEY block 
offset, 6-68 
SIZ2 field in KEY block 
offset, 6-68 
S1Z3 field in KEY block 
offset, 6-68 
SIZ4 field in KEY block 
offset, 6-68 
SIZ5 field in KEY block 
offset, 6-68 
SIZ6 field in KEY block 
offset, 6-68 
SIZ7 field in KEY block 
offset, 6-68 
SPACE operation, 4-14 
SSPACE macro, 5-120 
Stream, 4-2 
connecting 
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See CONNECT operation CLOSE operation, 5-4 
disconnecting CREATE operation, 5-21 
See DISCONNECT operation DISPLAY operation, 5-32 
internal identifier ENTER operation, 5-38 
See ISI field in RAB ERASE operation, 5-43 
unlocking bucket EXTEND operation, 5-47 
See FREE operation offset, 6-22 
writing buffers OPEN operation, 5-82 
See FLUSH operation PARSE operation, 5-89 
Stream context REMOVE operation, 5-105 
advancing to next volume RENAME operation, 5-112 
See NXTVOL operation SEARCH operation, 5-118 
rewinding summary, 6-65 
See REWIND operation STV field in RAB, 2-15, 4-2 
Stream operation CONNECT operation, 5-8 
block stream, 4-13 DELETE operation, 5-26 
record stream, 4-8 DISCONNECT operation, 5-27 
Stream operation macro FIND operation, 5-50, 5-53, 
SCONNECT, 5-6 5-55 
SDISCONNECT, 5-27 FLUSH operation, 5-56 
SFLUSH, 5-56 FREE operation, 5-58 
SFREE, 5-58 GET operation, 5-62, 5-65, 
SNXTVOL, 5-70 5-68 
SREWIND, 5-114 NXTVOL operation, 5-70 
SWAIT, 5-126 offset, 6-115 
declaring, C-3 PUT operation, 5-93, 5-97 
Stream record format READ operation, 5-99, 5-101 
See FBSSTM code in REM field REWIND operation, 5-115 
String key SPACE operation, 5-120 
See XBSSTG mask in DTP field summary, 6-142 
STS field in FAB, 2-15, 3-5 TRUNCATE operation, 5-122 
CLOSE operation, 5-4 UPDATE operation, 5-125 
CREATE operation, 5-21 WRITE operation, 5-128, 5-130 
DISPLAY operation, 5-32 SUS-family symbol 
ENTER operation, 5-38 declaring, C-3 
ERASE operation, 5-43 value, A-1 
EXTEND operation, 5-47 Success 
offset, 6-22 handler, 2-18 
OPEN operation, 5-82 SUM block 
PARSE operation, 5-89 chaining to FAB, 2-13 
REMOVE operation, 5-105 declaring, 2-9 
RENAME operation, 5-112 initializing, 2-10 
SEARCH operation, 5-118 summary, 6-145 
summary, 6-64 Summary XAB 
STS field in RAB, 2-15, 4-2 See SUM block 
CONNECT operation, 5-8 Supersession 
DELETE operation, 5-26 See FBSSUP mask in FOP field 
DISCONNECT operation, 5-27 Symbol-declaration macro, 2-2 
FIND operation, 5-50, 5-53, SYN argument to RABSB macro, 2-8 
5-55 RSTS/E, D=-4 
FLUSH operation, 5-56 Synchronous operation 
FREE operation, 5-58 See RBSASY mask in ROP field 
GET operation, 5-62, 5-65, 
5-68 Temporary file 
NXTVOL operation, 5-70 See FBSTMP mask in FOP field 
offset, 6-115 Terminal device, 3-1, 5-20, 
PUT operation, 5-93, 5-97 5-37, 5-42, 5-77, 5-88, 
READ operation, 5-99, 5-101 5-104, 5-111, 5-117 
REWIND operation, 5-115 See FBSTRM mask in DEV field 
SPACE operation, 5-120 TKS field in KEY block 
summary, 6-141 DISPLAY operation, 5-31 
TRUNCATE operation, 5-122 offset, 6-68 
UPDATE operation, 5-125 OPEN operation, 5-81 
WRITE operation, 5-128, 5-130 summary, 6-93 
STV field in FAB, 2-15, 3-5 TRUNCATE operation, 4-11 
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STRUNCATE macro, 5-122 


UBF field in RAB, 4-7, 4-13 


CONNECT operation, 5-6 

GET operation, 5-61, 5-64, 
5-67 

offset, 6-115 

PUT operation, 5-92, 5-96 

READ operation, 5-98, 5-100 


summary, 6-143 
Undefined record format 
See FBSUDF code in REM field 
Unit-record device, 3-2, 5-20, 
5-37, 5-43, 5-77, 5-88, 
5-104, 5-111, 5-117 


UPD argument to ORGS macro, 2-3 


UPDATE operation, 4-11 
SUPDATE macro, 5-124 
declaring with ORGS macro, 2-3 

User buffer 
address 

See UBF field in RAB 
size 
See USZ field in RAB 

USZ field in RAB, 4-7, 4-13 
CONNECT operation, 5-6 
GET operation, 5-61, 5-64, 

5-67 
offset, 6-115 
PUT operation, 5-92, 5-96 
READ operation, 5-98, 5-100 


Summary, 6-144 
Variable-length record format 

See FBSVAR code in RFM field 
VBN 

See BKT field in RAB 
VBN access 

See BKT field in RAB 
VFC carriage control 

See FBSPRN mask in RAT field 
VFC header buffer address 

See RHB field in RAB 
VFC record format 

See FBSVFC code in REM field 
Virtual block number 

See BKT field in RAB 
Volume 

advancing to next 

See NXTVOL operation 


WAIT operation 
SWAIT macro, 
block stream, 4-14 
record stream, 4-9 

wCC field in NAM block 
offset, 6-94 
PARSE operation, 
SEARCH operation, 
summary, 6-106 

WDI field in NAM block 
offset, 6-94 
PARSE operation, 
SEARCH operation, 
Summary, 6-107 


5-126 


5-87 


5-116, 5-118 


5-87 


5-116, 5-118 
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Wildcard 
directory context 
See WDI field in NAM block 
file context 
See WCC field in NAM block 
operation 


See NBSWCH mask in FNB field 


Wildcard loop, 3-9 
Writable-block context, 
WRITE operation, 4-14 
SWRITE macro 
sequential access, 
VBN access, 5-129 


4-12 


5=127 


X$-family macro, 2-10 
declaring 
ALL block, 
DAT block, 
KEY block, 
PRO block, 
SUM block, 
XAB 
chaining 
See also 
See also 
See also 


to FAB, 2-13 
ALL block 
DAT block 
KEY block 
See also PRO block 
See also SUM block 
XAB field in FAB 
chaining XABs to FAB, 
CLOSE operation, 5-3 
CREATE operation, 5-9 
DISPLAY operation, 5-29 
ENTER operation, 5-35 
ERASE operation, 5-40 
EXTEND operation, 5-46 
offset, 6-24 
OPEN operation, 
PARSE operation, 
REMOVE operation, 
RENAME operation, 
SEARCH operation, 
summary, 6-66 
XABSB macro, 2-8 to 2-9, 
XABSBT macro, C-4 
XABSE macro, 2-10 
declaring, C-3 
XABOFS macro, C-4 
XBS-family symbol 
declaring 
ALL block, 
DAT block, 
KEY block, 
PRO block, 
SUM block, 
XAB, C-4 
XBSALL code in 
Summary, 6-10 
value, 6-2 
XBSBN2 code in DTP 
CREATE operation, 5-18 
DISPLAY operation, 5-31 
OPEN operation, 5-80 
value, 6-67 
XBSBN4 code in DTP field 
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5-73 

5-86 
5-102 
5-108 
5-116 
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to 
to 
to 
to 
to 


field, 


field 
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CREATE operation, 5-18 EXTEND operation, 5-47 
DISPLAY operation, 5-31 RSTS/E, D-3 to D-4 
OPEN operation, 5-80 value, 6-2 
value, 6-67 XBSNUL mask in FLG field 
XBSCHG mask in FLG field CREATE operation, 5-19 
CREATE operation, 5-19 DISPLAY operation, 5-31 
DISPLAY operation, 5-31 OPEN operation, 5-80 
OPEN operation, 5-80 summary, 6-78 
summary, 6-76 value, 6-67 
value, 6-67 XBSPAC code in DTP field 
XBSCTG mask in AOP field CREATE operation, 5-18 
CREATE operation, 5-18 DISPLAY operation, 5-31 
EXTEND operation, 5-47 OPEN operation, 5-80 
OPEN operation, 5-79 value, 6-67 
RSTS/E, D-4 XBSPRL code in BLN field 
Summary, 6-6 summary, 6-109 
value, 6-2 value, 6-108 
XBSCYL mask in ALN field XBSPRO code in COD field, 2-9 
RSTS/E, D-3 to D-4 summary, 6-110 
XBSDAT code in COD field, 2-8 value, 6-108 
summary, 6-17 XBSSML code in BLN field 
value, 6-14 summary, 6-146 
XBSDTL code in BLN field value, 6-145 
summary, 6-15 XBSSTG code in DTP field 
value, 6-14 CREATE operation, 5-18 
XBSDUP mask in FLG field DISPLAY operation, 5-31 
CREATE operation, 5-19 OPEN operation, 5-80 
DISPLAY operation, 5-31 value, 6-67 
OPEN operation, 5-80 XBSSUM code in COD field, 2-9 
summary, 6-77 summary, 6-147 
value, 6-67 value, 6-145 
XBSHRD mask in AOP field XBSVBN mask in ALN field 
CREATE operation, 5-17 CREATE operation, 5-17 
EXTEND operation, 5-47 EXTEND operation, 5-47 
of ALL block RSTS/E, D-3 to D-4 
RSX-1l, D-4 value, 6-2 
OPEN operation, 5-79 XBAOFS macro, C-4 
RSTS/E, D-4 XBDOFS macro, C-4 
summary, 6-7 XBKOFS macro, C-4 
value, 6-2 XBPOFS macro, C-4 
XBSIN2 code in DTP field XBSOFS macro, C-4 


CREATE operation, 5-18 
DISPLAY operation, 5-31 
OPEN operation, 5-80 
value, 6-67 

XBSIN4 code in DTP field 
CREATE operation, 5-18 
DISPLAY operation, 5-31 
OPEN operation, 5-80 
value, 6-67 

XBSINI mask in FLG field 
DISPLAY operation, 5-31 
OPEN operation, 5-80 
value, 6-67 

XBSKEY code in COD field, 2-8 
summary, 6-70 
value, 6-67 

XBSKYL code in BLN field 
summary, 6-69 
value, 6-67 

XBSLAL code in BLN field 
summary, 6-9 
value, 6-2 

XBSLBN mask in ALN field 
CREATE operation, 5-17 
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READER’S COMMENTS 


NOTE: This form is for document comments only. DIGITAL will use comments submitted on this form at the 
company’s discretion. If you require a written reply and are eligible to receive one under Software 
Performance Report (SPR) service, submit your comments on an SPR form. 


Did you find this manual understandable, usable, and well organized? Please make suggestions for improvement. 


Did you find errors in this manual? If so, specify the error and the page number. 


Please indicate the type of user/reader that you most nearly represent. 


()} Assembly language programmer 
(] Higher-level language programmer 
[J Occasional programmer (experienced) 
(] User with little programming experience 
(} Student programmer 
(_] Other (please specify) 
IN RG a ete 
Organization 
Street 
Oi a a Bite Ss ip Code 


or Country 
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